swarm-orchestrator 14.0.2 → 14.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (543) hide show
  1. package/CHANGELOG.md +390 -1
  2. package/README.md +217 -524
  3. package/dist/agent-escalation.js +74 -0
  4. package/dist/agent-escalation.js.map +1 -0
  5. package/dist/agent-prompt.js +55 -0
  6. package/dist/agent-prompt.js.map +1 -0
  7. package/dist/agent-run.js +350 -160
  8. package/dist/agent-run.js.map +1 -1
  9. package/dist/cli-bond-report.js +37 -0
  10. package/dist/cli-bond-report.js.map +1 -0
  11. package/dist/cli-bundle.js +64 -0
  12. package/dist/cli-bundle.js.map +1 -0
  13. package/dist/cli-calibrate.js +282 -0
  14. package/dist/cli-calibrate.js.map +1 -0
  15. package/dist/cli-ci.js +227 -0
  16. package/dist/cli-ci.js.map +1 -0
  17. package/dist/cli-command-definitions.js +134 -0
  18. package/dist/cli-command-definitions.js.map +1 -0
  19. package/dist/cli-evidence-summary.js +25 -0
  20. package/dist/cli-evidence-summary.js.map +1 -0
  21. package/dist/cli-gates.js +124 -0
  22. package/dist/cli-gates.js.map +1 -0
  23. package/dist/cli-init.js +175 -0
  24. package/dist/cli-init.js.map +1 -0
  25. package/dist/cli-model-default.js +107 -0
  26. package/dist/cli-model-default.js.map +1 -0
  27. package/dist/cli-model-preflight.js +18 -0
  28. package/dist/cli-model-preflight.js.map +1 -0
  29. package/dist/cli-options.js +104 -155
  30. package/dist/cli-options.js.map +1 -1
  31. package/dist/cli-parallel-output.js +158 -0
  32. package/dist/cli-parallel-output.js.map +1 -0
  33. package/dist/cli-parallel.js +585 -0
  34. package/dist/cli-parallel.js.map +1 -0
  35. package/dist/cli-preflight.js +33 -0
  36. package/dist/cli-preflight.js.map +1 -0
  37. package/dist/cli-provider-settings.js +21 -0
  38. package/dist/cli-provider-settings.js.map +1 -0
  39. package/dist/cli-run-commands.js +32 -23
  40. package/dist/cli-run-commands.js.map +1 -1
  41. package/dist/cli-run-report.js +63 -0
  42. package/dist/cli-run-report.js.map +1 -0
  43. package/dist/cli-run-settings.js +30 -0
  44. package/dist/cli-run-settings.js.map +1 -0
  45. package/dist/cli-runtime-inputs.js +25 -0
  46. package/dist/cli-runtime-inputs.js.map +1 -0
  47. package/dist/cli-select.js +23 -10
  48. package/dist/cli-select.js.map +1 -1
  49. package/dist/cli-session.js +286 -0
  50. package/dist/cli-session.js.map +1 -0
  51. package/dist/cli-task-contract.js +24 -0
  52. package/dist/cli-task-contract.js.map +1 -0
  53. package/dist/cli-task-cost.js +76 -0
  54. package/dist/cli-task-cost.js.map +1 -0
  55. package/dist/cli-task-goal.js +114 -0
  56. package/dist/cli-task-goal.js.map +1 -0
  57. package/dist/cli-terminal.js +103 -0
  58. package/dist/cli-terminal.js.map +1 -0
  59. package/dist/cli-verification-evidence.js +51 -0
  60. package/dist/cli-verification-evidence.js.map +1 -0
  61. package/dist/cli-verify-options.js +146 -0
  62. package/dist/cli-verify-options.js.map +1 -0
  63. package/dist/cli-verify.js +18 -0
  64. package/dist/cli-verify.js.map +1 -0
  65. package/dist/cli.js +259 -1376
  66. package/dist/cli.js.map +1 -1
  67. package/dist/config/approval-mode.js +26 -0
  68. package/dist/config/approval-mode.js.map +1 -0
  69. package/dist/config/init.js +67 -5
  70. package/dist/config/init.js.map +1 -1
  71. package/dist/config/interface-settings.js +7 -0
  72. package/dist/config/interface-settings.js.map +1 -0
  73. package/dist/config/node-harness.js +34 -0
  74. package/dist/config/node-harness.js.map +1 -0
  75. package/dist/config/package-discovery.js +50 -0
  76. package/dist/config/package-discovery.js.map +1 -0
  77. package/dist/config/settings.js +7 -0
  78. package/dist/config/settings.js.map +1 -1
  79. package/dist/config/swarm-toml.js +16 -3
  80. package/dist/config/swarm-toml.js.map +1 -1
  81. package/dist/core/compaction.js +29 -27
  82. package/dist/core/compaction.js.map +1 -1
  83. package/dist/core/degenerate-output.js +44 -0
  84. package/dist/core/degenerate-output.js.map +1 -0
  85. package/dist/core/loop.js +166 -18
  86. package/dist/core/loop.js.map +1 -1
  87. package/dist/core/model-cancellation.js +17 -0
  88. package/dist/core/model-cancellation.js.map +1 -0
  89. package/dist/core/model-client.js.map +1 -1
  90. package/dist/core/termination.js.map +1 -1
  91. package/dist/durable/controller-location.js +30 -0
  92. package/dist/durable/controller-location.js.map +1 -0
  93. package/dist/durable/legacy-run-store.js +86 -0
  94. package/dist/durable/legacy-run-store.js.map +1 -0
  95. package/dist/durable/recovery-context.js +179 -0
  96. package/dist/durable/recovery-context.js.map +1 -0
  97. package/dist/durable/run-journal.js +161 -0
  98. package/dist/durable/run-journal.js.map +1 -0
  99. package/dist/durable/run-store.js +203 -200
  100. package/dist/durable/run-store.js.map +1 -1
  101. package/dist/durable/session-evidence.js +21 -0
  102. package/dist/durable/session-evidence.js.map +1 -0
  103. package/dist/eval/agent-session.js +146 -0
  104. package/dist/eval/agent-session.js.map +1 -0
  105. package/dist/eval/arm-dispatch.js +33 -0
  106. package/dist/eval/arm-dispatch.js.map +1 -0
  107. package/dist/eval/arms.js +13 -5
  108. package/dist/eval/arms.js.map +1 -1
  109. package/dist/eval/campaign-history.js +48 -0
  110. package/dist/eval/campaign-history.js.map +1 -0
  111. package/dist/eval/campaign-record.js +232 -0
  112. package/dist/eval/campaign-record.js.map +1 -0
  113. package/dist/eval/campaign-run.js +30 -14
  114. package/dist/eval/campaign-run.js.map +1 -1
  115. package/dist/eval/deadline-overshoot.js +73 -0
  116. package/dist/eval/deadline-overshoot.js.map +1 -0
  117. package/dist/eval/empty-patch-attribution.js +19 -0
  118. package/dist/eval/empty-patch-attribution.js.map +1 -0
  119. package/dist/eval/endpoint-health.js +126 -0
  120. package/dist/eval/endpoint-health.js.map +1 -0
  121. package/dist/eval/false-green-rate.js +133 -0
  122. package/dist/eval/false-green-rate.js.map +1 -0
  123. package/dist/eval/feedback-study-analysis.js +747 -0
  124. package/dist/eval/feedback-study-analysis.js.map +1 -0
  125. package/dist/eval/feedback-study-report.js +156 -0
  126. package/dist/eval/feedback-study-report.js.map +1 -0
  127. package/dist/eval/feedback-study.js +854 -0
  128. package/dist/eval/feedback-study.js.map +1 -0
  129. package/dist/eval/first-run-observation.js +105 -0
  130. package/dist/eval/first-run-observation.js.map +1 -0
  131. package/dist/eval/frozen-campaign.js +127 -0
  132. package/dist/eval/frozen-campaign.js.map +1 -0
  133. package/dist/eval/goal-campaign-report.js +143 -0
  134. package/dist/eval/goal-campaign-report.js.map +1 -0
  135. package/dist/eval/goal-observation.js +50 -0
  136. package/dist/eval/goal-observation.js.map +1 -0
  137. package/dist/eval/goal-protocol.js +104 -0
  138. package/dist/eval/goal-protocol.js.map +1 -0
  139. package/dist/eval/known-total.js +7 -0
  140. package/dist/eval/known-total.js.map +1 -0
  141. package/dist/eval/npm-failure.js +24 -0
  142. package/dist/eval/npm-failure.js.map +1 -0
  143. package/dist/eval/oracle-challenge.js +80 -0
  144. package/dist/eval/oracle-challenge.js.map +1 -0
  145. package/dist/eval/oracle-filter.js +74 -7
  146. package/dist/eval/oracle-filter.js.map +1 -1
  147. package/dist/eval/patch-metrics.js +74 -0
  148. package/dist/eval/patch-metrics.js.map +1 -0
  149. package/dist/eval/pr-task-judge.js +241 -0
  150. package/dist/eval/pr-task-judge.js.map +1 -0
  151. package/dist/eval/pr-task-paths.js +26 -0
  152. package/dist/eval/pr-task-paths.js.map +1 -0
  153. package/dist/eval/protocol-fixture.js +97 -0
  154. package/dist/eval/protocol-fixture.js.map +1 -0
  155. package/dist/eval/protocol.js +80 -0
  156. package/dist/eval/protocol.js.map +1 -0
  157. package/dist/eval/reach-pressure-analysis.js +507 -0
  158. package/dist/eval/reach-pressure-analysis.js.map +1 -0
  159. package/dist/eval/reach-pressure-derivation.js +201 -0
  160. package/dist/eval/reach-pressure-derivation.js.map +1 -0
  161. package/dist/eval/reach-pressure-report.js +266 -0
  162. package/dist/eval/reach-pressure-report.js.map +1 -0
  163. package/dist/eval/reach-pressure.js +645 -0
  164. package/dist/eval/reach-pressure.js.map +1 -0
  165. package/dist/eval/repair-progress.js +109 -0
  166. package/dist/eval/repair-progress.js.map +1 -0
  167. package/dist/eval/sealed-workspace.js +61 -0
  168. package/dist/eval/sealed-workspace.js.map +1 -0
  169. package/dist/eval/security-corpus.js +139 -0
  170. package/dist/eval/security-corpus.js.map +1 -0
  171. package/dist/eval/statistics.js +187 -0
  172. package/dist/eval/statistics.js.map +1 -1
  173. package/dist/eval/task-difficulty.js +28 -0
  174. package/dist/eval/task-difficulty.js.map +1 -0
  175. package/dist/eval/task-identity.js +0 -0
  176. package/dist/eval/task-identity.js.map +1 -0
  177. package/dist/eval/test-case-split.js +56 -5
  178. package/dist/eval/test-case-split.js.map +1 -1
  179. package/dist/eval/verification-closure.js +56 -0
  180. package/dist/eval/verification-closure.js.map +1 -0
  181. package/dist/evidence/acceptance-contract.js +34 -0
  182. package/dist/evidence/acceptance-contract.js.map +1 -0
  183. package/dist/evidence/attestation.js +63 -10
  184. package/dist/evidence/attestation.js.map +1 -1
  185. package/dist/evidence/behavior-check.js +93 -0
  186. package/dist/evidence/behavior-check.js.map +1 -0
  187. package/dist/evidence/blob-manifest.js +5 -1
  188. package/dist/evidence/blob-manifest.js.map +1 -1
  189. package/dist/evidence/browser-execution.js +12 -0
  190. package/dist/evidence/browser-execution.js.map +1 -0
  191. package/dist/evidence/bundle-manifest.js +4 -0
  192. package/dist/evidence/bundle-manifest.js.map +1 -1
  193. package/dist/evidence/bundle.js +36 -4
  194. package/dist/evidence/bundle.js.map +1 -1
  195. package/dist/evidence/canonical-json.js +1 -1
  196. package/dist/evidence/canonical-json.js.map +1 -1
  197. package/dist/evidence/ci-summary.js +58 -0
  198. package/dist/evidence/ci-summary.js.map +1 -0
  199. package/dist/evidence/frozen-json.js +10 -0
  200. package/dist/evidence/frozen-json.js.map +1 -0
  201. package/dist/evidence/goal-contract.js +90 -0
  202. package/dist/evidence/goal-contract.js.map +1 -0
  203. package/dist/evidence/ledger-file.js +45 -0
  204. package/dist/evidence/ledger-file.js.map +1 -0
  205. package/dist/evidence/ledger-record.js +28 -0
  206. package/dist/evidence/ledger-record.js.map +1 -1
  207. package/dist/evidence/ledger.js +19 -9
  208. package/dist/evidence/ledger.js.map +1 -1
  209. package/dist/evidence/model-call-recording.js +32 -5
  210. package/dist/evidence/model-call-recording.js.map +1 -1
  211. package/dist/evidence/predicate-catalogue.js +219 -0
  212. package/dist/evidence/predicate-catalogue.js.map +1 -1
  213. package/dist/evidence/record-kind.js +2 -0
  214. package/dist/evidence/record-kind.js.map +1 -1
  215. package/dist/evidence/replay.js +14 -0
  216. package/dist/evidence/replay.js.map +1 -1
  217. package/dist/evidence/routine-claims.js +38 -0
  218. package/dist/evidence/routine-claims.js.map +1 -0
  219. package/dist/evidence/run-assessment.js +131 -0
  220. package/dist/evidence/run-assessment.js.map +1 -0
  221. package/dist/evidence/run-spec.js +19 -4
  222. package/dist/evidence/run-spec.js.map +1 -1
  223. package/dist/evidence/scrub.js +1 -0
  224. package/dist/evidence/scrub.js.map +1 -1
  225. package/dist/evidence/session.js +8 -1
  226. package/dist/evidence/session.js.map +1 -1
  227. package/dist/evidence/signer-trust.js.map +1 -1
  228. package/dist/evidence/signing.js +14 -6
  229. package/dist/evidence/signing.js.map +1 -1
  230. package/dist/evidence/task-contract.js +120 -0
  231. package/dist/evidence/task-contract.js.map +1 -0
  232. package/dist/evidence/task-preset.js +52 -0
  233. package/dist/evidence/task-preset.js.map +1 -0
  234. package/dist/evidence/transcript.js +89 -0
  235. package/dist/evidence/transcript.js.map +1 -0
  236. package/dist/evidence/verdict.js +62 -2
  237. package/dist/evidence/verdict.js.map +1 -1
  238. package/dist/evidence/verifier/behavior.d.mts +5 -0
  239. package/dist/evidence/verifier/behavior.mjs +161 -0
  240. package/dist/evidence/verifier/controller.d.mts +15 -0
  241. package/dist/evidence/verifier/controller.mjs +751 -0
  242. package/dist/evidence/verifier/rederive.d.mts +44 -1
  243. package/dist/evidence/verifier/rederive.mjs +253 -49
  244. package/dist/evidence/verifier/status.d.mts +9 -0
  245. package/dist/evidence/verifier/status.mjs +157 -0
  246. package/dist/evidence/verifier/upgrade.d.mts +6 -0
  247. package/dist/evidence/verifier/upgrade.mjs +80 -0
  248. package/dist/evidence/verifier/verify.d.mts +8 -1
  249. package/dist/evidence/verifier/verify.mjs +885 -13
  250. package/dist/evidence/verify-report.js +25 -8
  251. package/dist/evidence/verify-report.js.map +1 -1
  252. package/dist/exec/child-environment.js +40 -0
  253. package/dist/exec/child-environment.js.map +1 -1
  254. package/dist/exec/container-backend.js +138 -35
  255. package/dist/exec/container-backend.js.map +1 -1
  256. package/dist/exec/container-image.js +7 -0
  257. package/dist/exec/container-image.js.map +1 -0
  258. package/dist/exec/controlled-network.js +39 -0
  259. package/dist/exec/controlled-network.js.map +1 -0
  260. package/dist/exec/execution-mode.js +46 -19
  261. package/dist/exec/execution-mode.js.map +1 -1
  262. package/dist/exec/isolation-option.js +3 -1
  263. package/dist/exec/isolation-option.js.map +1 -1
  264. package/dist/exec/resource-pool.js +47 -0
  265. package/dist/exec/resource-pool.js.map +1 -0
  266. package/dist/exec/run-cancellation.js +2 -1
  267. package/dist/exec/run-cancellation.js.map +1 -1
  268. package/dist/exec/run-process.js +31 -10
  269. package/dist/exec/run-process.js.map +1 -1
  270. package/dist/exec/runtime-resource.js +93 -0
  271. package/dist/exec/runtime-resource.js.map +1 -0
  272. package/dist/exec/task-contract-enforcement.js +28 -0
  273. package/dist/exec/task-contract-enforcement.js.map +1 -0
  274. package/dist/gates/acceptance-package.js +75 -0
  275. package/dist/gates/acceptance-package.js.map +1 -0
  276. package/dist/gates/auto-resolve.js +18 -0
  277. package/dist/gates/auto-resolve.js.map +1 -1
  278. package/dist/gates/behavior-artifacts.js +88 -0
  279. package/dist/gates/behavior-artifacts.js.map +1 -0
  280. package/dist/gates/behavior-check.js +144 -0
  281. package/dist/gates/behavior-check.js.map +1 -0
  282. package/dist/gates/browser-instrument-runner.mjs +80 -0
  283. package/dist/gates/browser-instrument.js +33 -0
  284. package/dist/gates/browser-instrument.js.map +1 -0
  285. package/dist/gates/browser-results.js +75 -0
  286. package/dist/gates/browser-results.js.map +1 -0
  287. package/dist/gates/certification.js +65 -0
  288. package/dist/gates/certification.js.map +1 -0
  289. package/dist/gates/change-source.js +150 -0
  290. package/dist/gates/change-source.js.map +1 -0
  291. package/dist/gates/contract-executor.js +81 -0
  292. package/dist/gates/contract-executor.js.map +1 -0
  293. package/dist/gates/contract-scope.js +21 -0
  294. package/dist/gates/contract-scope.js.map +1 -0
  295. package/dist/gates/contract-verification.js +51 -0
  296. package/dist/gates/contract-verification.js.map +1 -0
  297. package/dist/gates/default-gates.js +19 -152
  298. package/dist/gates/default-gates.js.map +1 -1
  299. package/dist/gates/dependency-install.js +181 -0
  300. package/dist/gates/dependency-install.js.map +1 -0
  301. package/dist/gates/engine.js +13 -2
  302. package/dist/gates/engine.js.map +1 -1
  303. package/dist/gates/environment-preflight.js +108 -0
  304. package/dist/gates/environment-preflight.js.map +1 -0
  305. package/dist/gates/file-set-tool.js +57 -13
  306. package/dist/gates/file-set-tool.js.map +1 -1
  307. package/dist/gates/file-set.js +105 -9
  308. package/dist/gates/file-set.js.map +1 -1
  309. package/dist/gates/gate-command.js +69 -0
  310. package/dist/gates/gate-command.js.map +1 -0
  311. package/dist/gates/gate-definition.js.map +1 -1
  312. package/dist/gates/gate-runner.js +50 -45
  313. package/dist/gates/gate-runner.js.map +1 -1
  314. package/dist/gates/gate-set-seal.js +11 -1
  315. package/dist/gates/gate-set-seal.js.map +1 -1
  316. package/dist/gates/git-workspace.js +18 -2
  317. package/dist/gates/git-workspace.js.map +1 -1
  318. package/dist/gates/github-source.js +44 -0
  319. package/dist/gates/github-source.js.map +1 -0
  320. package/dist/gates/goal-acceptance.js +167 -0
  321. package/dist/gates/goal-acceptance.js.map +1 -0
  322. package/dist/gates/goal-checkout.js +109 -0
  323. package/dist/gates/goal-checkout.js.map +1 -0
  324. package/dist/gates/goal-effects.js +38 -0
  325. package/dist/gates/goal-effects.js.map +1 -0
  326. package/dist/gates/http-check-runner.mjs +96 -0
  327. package/dist/gates/independent-checks.js +34 -0
  328. package/dist/gates/independent-checks.js.map +1 -0
  329. package/dist/gates/independent-verification.js +623 -97
  330. package/dist/gates/independent-verification.js.map +1 -1
  331. package/dist/gates/inspection-gates.js +25 -3
  332. package/dist/gates/inspection-gates.js.map +1 -1
  333. package/dist/gates/measure-snapshot.js +5 -0
  334. package/dist/gates/measure-snapshot.js.map +1 -1
  335. package/dist/gates/mutant-parse.js +47 -0
  336. package/dist/gates/mutant-parse.js.map +1 -0
  337. package/dist/gates/mutant-witness.js +99 -0
  338. package/dist/gates/mutant-witness.js.map +1 -0
  339. package/dist/gates/node-command-runner.js +67 -6
  340. package/dist/gates/node-command-runner.js.map +1 -1
  341. package/dist/gates/node-gates.js +91 -0
  342. package/dist/gates/node-gates.js.map +1 -0
  343. package/dist/gates/node-test-command.js +91 -23
  344. package/dist/gates/node-test-command.js.map +1 -1
  345. package/dist/gates/oracle-bond-run.js +128 -0
  346. package/dist/gates/oracle-bond-run.js.map +1 -0
  347. package/dist/gates/oracle-bond.js +49 -0
  348. package/dist/gates/oracle-bond.js.map +1 -0
  349. package/dist/gates/oracle-instrumentation.js +115 -0
  350. package/dist/gates/oracle-instrumentation.js.map +1 -0
  351. package/dist/gates/oracle-mutants.js +628 -0
  352. package/dist/gates/oracle-mutants.js.map +1 -0
  353. package/dist/gates/oracle-reach.js +175 -0
  354. package/dist/gates/oracle-reach.js.map +1 -0
  355. package/dist/gates/package-scope.js +115 -0
  356. package/dist/gates/package-scope.js.map +1 -0
  357. package/dist/gates/parsers.js +3 -0
  358. package/dist/gates/parsers.js.map +1 -1
  359. package/dist/gates/prepare-dependencies.js +35 -0
  360. package/dist/gates/prepare-dependencies.js.map +1 -0
  361. package/dist/gates/prepared-python.js +92 -0
  362. package/dist/gates/prepared-python.js.map +1 -0
  363. package/dist/gates/preset-verification.js +65 -0
  364. package/dist/gates/preset-verification.js.map +1 -0
  365. package/dist/gates/project-environment.js +59 -0
  366. package/dist/gates/project-environment.js.map +1 -0
  367. package/dist/gates/project-type.js +79 -15
  368. package/dist/gates/project-type.js.map +1 -1
  369. package/dist/gates/python-gates.js +67 -0
  370. package/dist/gates/python-gates.js.map +1 -0
  371. package/dist/gates/ratchet.js +6 -1
  372. package/dist/gates/ratchet.js.map +1 -1
  373. package/dist/gates/repair-policy.js +64 -0
  374. package/dist/gates/repair-policy.js.map +1 -0
  375. package/dist/gates/resolved-path.js +21 -0
  376. package/dist/gates/resolved-path.js.map +1 -0
  377. package/dist/gates/runner-results.js +77 -0
  378. package/dist/gates/runner-results.js.map +1 -0
  379. package/dist/gates/scratch-index.js +14 -1
  380. package/dist/gates/scratch-index.js.map +1 -1
  381. package/dist/gates/structured-runner.js +37 -0
  382. package/dist/gates/structured-runner.js.map +1 -0
  383. package/dist/gates/upgrade-contract.js +81 -0
  384. package/dist/gates/upgrade-contract.js.map +1 -0
  385. package/dist/gates/upgrade-resolution.js +56 -0
  386. package/dist/gates/upgrade-resolution.js.map +1 -0
  387. package/dist/gates/v8-coverage.js +142 -0
  388. package/dist/gates/v8-coverage.js.map +1 -0
  389. package/dist/install/health.js +26 -0
  390. package/dist/install/health.js.map +1 -1
  391. package/dist/node-floor-check.js +12 -0
  392. package/dist/node-floor-check.js.map +1 -0
  393. package/dist/node-floor.js +32 -13
  394. package/dist/node-floor.js.map +1 -1
  395. package/dist/providers/ai-sdk-model-client.js +32 -2
  396. package/dist/providers/ai-sdk-model-client.js.map +1 -1
  397. package/dist/providers/registry.js +8 -4
  398. package/dist/providers/registry.js.map +1 -1
  399. package/dist/select/calibration-measures.js +17 -3
  400. package/dist/select/calibration-measures.js.map +1 -1
  401. package/dist/select/calibration-run.js +1 -1
  402. package/dist/select/calibration-run.js.map +1 -1
  403. package/dist/select/production-routing.js +66 -0
  404. package/dist/select/production-routing.js.map +1 -0
  405. package/dist/select/recommendation.js +10 -0
  406. package/dist/select/recommendation.js.map +1 -1
  407. package/dist/select/routing-candidates.js +29 -0
  408. package/dist/select/routing-candidates.js.map +1 -0
  409. package/dist/select/routing-mode.js +10 -5
  410. package/dist/select/routing-mode.js.map +1 -1
  411. package/dist/select/served-pick.js +36 -0
  412. package/dist/select/served-pick.js.map +1 -0
  413. package/dist/select/task-cost.js +10 -3
  414. package/dist/select/task-cost.js.map +1 -1
  415. package/dist/select/ucb.js +4 -3
  416. package/dist/select/ucb.js.map +1 -1
  417. package/dist/swarm-verify.js +51 -0
  418. package/dist/swarm-verify.js.map +1 -0
  419. package/dist/task-brief.js +20 -0
  420. package/dist/task-brief.js.map +1 -0
  421. package/dist/tools/bounded-file.js +66 -0
  422. package/dist/tools/bounded-file.js.map +1 -0
  423. package/dist/tools/chokepoint-record.js +16 -2
  424. package/dist/tools/chokepoint-record.js.map +1 -1
  425. package/dist/tools/chokepoint.js +45 -3
  426. package/dist/tools/chokepoint.js.map +1 -1
  427. package/dist/tools/claim-reference-tool.js +17 -0
  428. package/dist/tools/claim-reference-tool.js.map +1 -0
  429. package/dist/tools/file-tools.js +18 -10
  430. package/dist/tools/file-tools.js.map +1 -1
  431. package/dist/tools/policy-guard.js +25 -2
  432. package/dist/tools/policy-guard.js.map +1 -1
  433. package/dist/tools/regex-worker.js +63 -0
  434. package/dist/tools/regex-worker.js.map +1 -0
  435. package/dist/tools/search-tool.js +57 -30
  436. package/dist/tools/search-tool.js.map +1 -1
  437. package/dist/tools/shell-command.js +47 -1
  438. package/dist/tools/shell-command.js.map +1 -1
  439. package/dist/tools/shell-tool.js +19 -5
  440. package/dist/tools/shell-tool.js.map +1 -1
  441. package/dist/tools/tool-definition.js +1 -1
  442. package/dist/tools/tool-definition.js.map +1 -1
  443. package/dist/tui/confirmation-queue.js +6 -6
  444. package/dist/tui/confirmation-queue.js.map +1 -1
  445. package/dist/tui/controller-screen-model.js +28 -0
  446. package/dist/tui/controller-screen-model.js.map +1 -0
  447. package/dist/tui/controller-screen.js +17 -0
  448. package/dist/tui/controller-screen.js.map +1 -0
  449. package/dist/tui/elapsed.js +13 -0
  450. package/dist/tui/elapsed.js.map +1 -1
  451. package/dist/tui/evidence-panel.js +72 -12
  452. package/dist/tui/evidence-panel.js.map +1 -1
  453. package/dist/tui/glyphs.js +23 -0
  454. package/dist/tui/glyphs.js.map +1 -0
  455. package/dist/tui/hyperlink.js +38 -0
  456. package/dist/tui/hyperlink.js.map +1 -0
  457. package/dist/tui/key-bindings.js +2 -0
  458. package/dist/tui/key-bindings.js.map +1 -1
  459. package/dist/tui/key-dispatcher.js +5 -2
  460. package/dist/tui/key-dispatcher.js.map +1 -1
  461. package/dist/tui/layout.js +3 -1
  462. package/dist/tui/layout.js.map +1 -1
  463. package/dist/tui/plain-lines.js +2 -0
  464. package/dist/tui/plain-lines.js.map +1 -1
  465. package/dist/tui/screen-model.js +127 -24
  466. package/dist/tui/screen-model.js.map +1 -1
  467. package/dist/tui/screen.js +5 -3
  468. package/dist/tui/screen.js.map +1 -1
  469. package/dist/tui/session-interface.js +23 -5
  470. package/dist/tui/session-interface.js.map +1 -1
  471. package/dist/tui/session-store.js +3 -3
  472. package/dist/tui/session-store.js.map +1 -1
  473. package/dist/tui/session-view.js +20 -0
  474. package/dist/tui/session-view.js.map +1 -1
  475. package/dist/workers/bootstrap-history.js +66 -0
  476. package/dist/workers/bootstrap-history.js.map +1 -0
  477. package/dist/workers/bootstrap-schema.js +48 -0
  478. package/dist/workers/bootstrap-schema.js.map +1 -0
  479. package/dist/workers/bootstrap.js +257 -0
  480. package/dist/workers/bootstrap.js.map +1 -0
  481. package/dist/workers/controller-administration.js +80 -0
  482. package/dist/workers/controller-administration.js.map +1 -0
  483. package/dist/workers/controller-cleanup.js +16 -0
  484. package/dist/workers/controller-cleanup.js.map +1 -0
  485. package/dist/workers/controller-configuration.js +94 -0
  486. package/dist/workers/controller-configuration.js.map +1 -0
  487. package/dist/workers/controller-events.js +99 -0
  488. package/dist/workers/controller-events.js.map +1 -0
  489. package/dist/workers/controller-jobs.js +225 -0
  490. package/dist/workers/controller-jobs.js.map +1 -0
  491. package/dist/workers/controller-launch.js +87 -0
  492. package/dist/workers/controller-launch.js.map +1 -0
  493. package/dist/workers/controller-owner.js +65 -0
  494. package/dist/workers/controller-owner.js.map +1 -0
  495. package/dist/workers/controller-recovery.js +344 -0
  496. package/dist/workers/controller-recovery.js.map +1 -0
  497. package/dist/workers/controller-revisions.js +171 -0
  498. package/dist/workers/controller-revisions.js.map +1 -0
  499. package/dist/workers/controller-schedule.js +18 -0
  500. package/dist/workers/controller-schedule.js.map +1 -0
  501. package/dist/workers/controller-scheduler.js +282 -0
  502. package/dist/workers/controller-scheduler.js.map +1 -0
  503. package/dist/workers/controller-scope.js +59 -0
  504. package/dist/workers/controller-scope.js.map +1 -0
  505. package/dist/workers/controller-state.js +457 -0
  506. package/dist/workers/controller-state.js.map +1 -0
  507. package/dist/workers/controller-verification.js +41 -0
  508. package/dist/workers/controller-verification.js.map +1 -0
  509. package/dist/workers/controller-view.js +136 -0
  510. package/dist/workers/controller-view.js.map +1 -0
  511. package/dist/workers/coordination.js +165 -0
  512. package/dist/workers/coordination.js.map +1 -0
  513. package/dist/workers/goal-candidates.js +92 -0
  514. package/dist/workers/goal-candidates.js.map +1 -0
  515. package/dist/workers/goal-outcome.js +102 -0
  516. package/dist/workers/goal-outcome.js.map +1 -0
  517. package/dist/workers/goal-repair.js +103 -0
  518. package/dist/workers/goal-repair.js.map +1 -0
  519. package/dist/workers/goal-selection.js +81 -0
  520. package/dist/workers/goal-selection.js.map +1 -0
  521. package/dist/workers/graph-record.js +1 -3
  522. package/dist/workers/graph-record.js.map +1 -1
  523. package/dist/workers/graph-revision.js +286 -0
  524. package/dist/workers/graph-revision.js.map +1 -0
  525. package/dist/workers/merge-queue.js +47 -6
  526. package/dist/workers/merge-queue.js.map +1 -1
  527. package/dist/workers/parallel-report.js +12 -1
  528. package/dist/workers/parallel-report.js.map +1 -1
  529. package/dist/workers/parallel-run.js +439 -201
  530. package/dist/workers/parallel-run.js.map +1 -1
  531. package/dist/workers/planner-run.js +61 -15
  532. package/dist/workers/planner-run.js.map +1 -1
  533. package/dist/workers/run-context.js +204 -0
  534. package/dist/workers/run-context.js.map +1 -0
  535. package/dist/workers/task-contract.js +15 -80
  536. package/dist/workers/task-contract.js.map +1 -1
  537. package/dist/workers/worktree.js +69 -28
  538. package/dist/workers/worktree.js.map +1 -1
  539. package/docs/README.md +5 -0
  540. package/docs/build-guide.md +49 -10
  541. package/docs/claims.md +20 -0
  542. package/docs/security-coverage.md +40 -0
  543. package/package.json +11 -5
@@ -0,0 +1,175 @@
1
+ import { execFile } from "node:child_process";
2
+ import { statSync } from "node:fs";
3
+ import { access, readFile, writeFile } from "node:fs/promises";
4
+ import { basename, join } from "node:path";
5
+ import { promisify } from "node:util";
6
+ import { askOnTerminal } from "./cli-terminal.js";
7
+ import { withToolsApproval } from "./config/approval-mode.js";
8
+ import { initializeSwarmToml, initWouldHelp } from "./config/init.js";
9
+ import { hasAnyManifest, nodeHarnessFiles } from "./config/node-harness.js";
10
+ import { discoverPackages } from "./config/package-discovery.js";
11
+ import { parseSwarmToml, swarmTomlFileName } from "./config/swarm-toml.js";
12
+ const runProcess = promisify(execFile);
13
+ const initOnDisk = (workspace) => ({
14
+ workspace,
15
+ exists: (path) => access(path).then(() => true, () => false),
16
+ readFile: (path) => readFile(path, "utf8").catch((cause) => {
17
+ if (cause.code === "ENOENT") {
18
+ return null;
19
+ }
20
+ throw cause;
21
+ }),
22
+ writeFile: (path, text) => writeFile(path, text, "utf8"),
23
+ });
24
+ function describePlannedGate(gate) {
25
+ return (` ${gate.id}: ${gate.command} (${gate.parser}, ${gate.severity}) from scripts.${gate.script}` +
26
+ (gate.reason === null ? "" : `\n ${gate.reason}`));
27
+ }
28
+ /** `swarm init`: the file a first run can work from, from what package.json declares. */
29
+ export async function init(options) {
30
+ if (!statSync(options.workspace, { throwIfNoEntry: false })?.isDirectory()) {
31
+ throw new Error(`workspace ${options.workspace} is not a directory. Create it, or pass --workspace.`);
32
+ }
33
+ if (options.listPackages) {
34
+ writeOut((await discoverPackages(options.workspace)).join("\n") ||
35
+ "No declared Node workspace packages; Python directories can be selected explicitly with --package.");
36
+ return 0;
37
+ }
38
+ const outcome = await initializeSwarmToml({
39
+ ...initOnDisk(options.workspace),
40
+ ...(options.packages ? { packages: options.packages } : {}),
41
+ });
42
+ writeOut(`wrote ${outcome.path}`);
43
+ for (const gate of outcome.gates) {
44
+ writeOut(describePlannedGate(gate));
45
+ }
46
+ if (outcome.gates.length === 0) {
47
+ writeOut(" no gate written: package.json declares none of test, lint, typecheck or build");
48
+ }
49
+ return 0;
50
+ }
51
+ /**
52
+ * The first run in a workspace with a manifest and no swarm.toml offers to write one, in the
53
+ * one question the chokepoint's plain path asks and with the same answer key. Off a terminal
54
+ * nothing is asked and nothing is written: the run works from what the harness detects, as
55
+ * it always did.
56
+ */
57
+ export async function offerInit(workspace) {
58
+ const onDisk = initOnDisk(workspace);
59
+ const isTty = process.stdout.isTTY === true && process.stdin.isTTY === true;
60
+ if (!isTty || !(await initWouldHelp(onDisk))) {
61
+ return;
62
+ }
63
+ process.stderr.write("no swarm.toml here, and package.json declares scripts: swarm init would write one with " +
64
+ "the gates read off them, each naming the rule that reads it.\n");
65
+ const answer = await askOnTerminal('Run "swarm init" first? [y/N] ');
66
+ if (answer.trim().toLowerCase() !== "y") {
67
+ return;
68
+ }
69
+ const outcome = await initializeSwarmToml(onDisk);
70
+ process.stderr.write(`wrote ${outcome.path}\n`);
71
+ for (const gate of outcome.gates) {
72
+ process.stderr.write(`${describePlannedGate(gate)}\n`);
73
+ }
74
+ }
75
+ function writeOut(line) {
76
+ process.stdout.write(`${line}\n`);
77
+ }
78
+ /**
79
+ * Why a run in a repository with no manifest stops before it starts. The criteria are sealed
80
+ * from the base commit before the model is asked for anything, so a manifest the model adds
81
+ * on the way cannot change what measures it: a run in such a workspace spent three attempts
82
+ * failing four gates that each said "add the manifest".
83
+ */
84
+ export class NoManifestError extends Error {
85
+ constructor(workspace) {
86
+ super(`no manifest in ${workspace}: none of package.json, pyproject.toml, Cargo.toml or go.mod, ` +
87
+ "so no gate can measure what a run writes, and the criteria are sealed from the base " +
88
+ "commit before the model runs. Add the manifest for the language you want and commit " +
89
+ "it, or run swarm on a terminal and answer y to have it add a Node harness (a " +
90
+ "package.json running node --test, and a .gitignore) and commit that.");
91
+ this.name = "NoManifestError";
92
+ }
93
+ }
94
+ /**
95
+ * Writes the Node harness into a repository with no manifest and commits it, so the base the
96
+ * run is sealed from carries it. Committed on the current branch, with the person's own git
97
+ * identity, because they asked for it on the terminal: this is their commit, not the run's.
98
+ */
99
+ export async function establishNodeHarness(workspace, environment = process.env) {
100
+ const files = nodeHarnessFiles(basename(workspace));
101
+ for (const [name, text] of Object.entries(files)) {
102
+ await writeFile(join(workspace, name), text, { flag: "wx" });
103
+ }
104
+ const git = async (args) => (await runProcess("git", [...args], { cwd: workspace, env: environment })).stdout.trim();
105
+ await git(["add", "--", ...Object.keys(files)]);
106
+ try {
107
+ await git(["commit", "-q", "-m", "Add a Node test harness so swarm can measure this project"]);
108
+ }
109
+ catch (cause) {
110
+ // The files are the person's harness and stay written; only the commit is theirs to finish.
111
+ const said = cause.stderr?.trim().split("\n")[0] ?? String(cause);
112
+ throw new Error(`${Object.keys(files).join(" and ")} were written to ${workspace} but could not be ` +
113
+ `committed (${said}). Set your git identity with git config user.name and ` +
114
+ "git config user.email, commit them, and run again.");
115
+ }
116
+ return { commit: await git(["rev-parse", "HEAD"]) };
117
+ }
118
+ /**
119
+ * A repository with no manifest either gets the Node harness, on a terminal and with a yes,
120
+ * or stops here with the remedy named. True where the harness was added and the base moved.
121
+ */
122
+ export async function offerNodeHarness(workspace) {
123
+ const onDisk = initOnDisk(workspace);
124
+ if (await hasAnyManifest((manifest) => onDisk.readFile(join(workspace, manifest)))) {
125
+ return false;
126
+ }
127
+ const isTty = process.stdout.isTTY === true && process.stdin.isTTY === true;
128
+ if (!isTty) {
129
+ throw new NoManifestError(workspace);
130
+ }
131
+ process.stderr.write(`no manifest in ${workspace}, so no gate can measure what a run writes. swarm can add a ` +
132
+ "Node harness, a package.json running node --test and a .gitignore, and commit it.\n");
133
+ const answer = await askOnTerminal("Add the Node harness and commit it? [y/N] ");
134
+ if (answer.trim().toLowerCase() !== "y") {
135
+ throw new NoManifestError(workspace);
136
+ }
137
+ const established = await establishNodeHarness(workspace);
138
+ process.stderr.write(`committed the Node harness as ${established.commit.slice(0, 12)}\n`);
139
+ return true;
140
+ }
141
+ /** The offer as it runs from the composition root: the real terminal and the real files. */
142
+ export function approvalOfferOnDisk(workspace) {
143
+ const onDisk = initOnDisk(workspace);
144
+ return {
145
+ workspace,
146
+ isTty: process.stdout.isTTY === true && process.stdin.isTTY === true,
147
+ ask: askOnTerminal,
148
+ readFile: onDisk.readFile,
149
+ writeFile: onDisk.writeFile,
150
+ };
151
+ }
152
+ /**
153
+ * Asked once per workspace: whether shell-allowlist prompts are answered by the run or by the
154
+ * person, written into swarm.toml so the next run does not ask (ADR 0011). A derivation
155
+ * heuristic prompt asks under either answer. Off a terminal nothing is asked and nothing is
156
+ * written; the default of asking stands.
157
+ */
158
+ export async function offerApprovalMode(deps) {
159
+ const path = join(deps.workspace, swarmTomlFileName);
160
+ const existing = await deps.readFile(path);
161
+ if (existing !== null && parseSwarmToml(existing, path).tools.approval !== null) {
162
+ return;
163
+ }
164
+ if (!deps.isTty) {
165
+ return;
166
+ }
167
+ process.stderr.write("Off-allowlist commands (pip, curl, make and the like) ask before they run. swarm can " +
168
+ "answer those itself for this workspace and record each one; a command that looks copied " +
169
+ "from something the model just read still asks either way.\n");
170
+ const answer = await deps.ask("Approve off-allowlist commands automatically here? [y/N] ");
171
+ const mode = answer.trim().toLowerCase() === "y" ? "auto" : "ask";
172
+ await deps.writeFile(path, withToolsApproval(existing ?? "", mode));
173
+ process.stderr.write(`wrote ${path}: [tools] approval = "${mode}"\n`);
174
+ }
175
+ //# sourceMappingURL=cli-init.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-init.js","sourceRoot":"","sources":["../src/cli-init.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,107 @@
1
+ import { defaultLocalEndpoints, discoverLocalEndpoints, } from "./providers/local-discovery.js";
2
+ import { readBundledShortlist } from "./select/bundled-shortlist.js";
3
+ import { probeHardware } from "./select/hardware-probe.js";
4
+ import { frontierFallbackOrder } from "./select/model-fallback.js";
5
+ import { pickServedModel } from "./select/served-pick.js";
6
+ import { systemProbeEnvironment } from "./select/system-probe.js";
7
+ /** Long enough for a local server to answer, short enough that an absent one is not a wait. */
8
+ const discoveryTimeoutMs = 1_500;
9
+ export class NoDefaultModelError extends Error {
10
+ constructor(served) {
11
+ const serving = served.length === 0
12
+ ? "no local backend answered on the default ports"
13
+ : served
14
+ .map((endpoint) => `${endpoint.name} serves ${endpoint.models.join(", ") || "nothing"}`)
15
+ .join("; ");
16
+ super(`no model to run: nothing pins one, no calibration has measured this machine, ${serving}, ` +
17
+ "and no ANTHROPIC_API_KEY, OPENAI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY is set. Pull a " +
18
+ "model (ollama pull <id>), set a key, or pass --model <provider:id>.");
19
+ this.name = "NoDefaultModelError";
20
+ }
21
+ }
22
+ /**
23
+ * What a run takes when nothing pins a model and no calibration pick exists (ADR 0011,
24
+ * decision 2): the best served local model for this hardware, a frontier provider only where
25
+ * nothing local is served, and a named stop where neither exists. A pinned local endpoint is
26
+ * asked instead of the default ports, under the runtime name whose default port it matches.
27
+ */
28
+ export async function defaultModelFor(settings, deps = systemDependencies(settings)) {
29
+ const served = await deps.discover();
30
+ const pinned = frontierWithKey(settings);
31
+ if (served.some((endpoint) => endpoint.models.length > 0)) {
32
+ const [profile, shortlist] = await Promise.all([deps.probe(), deps.shortlist()]);
33
+ const pick = pickServedModel({ served, shortlist, profile });
34
+ if (pick !== null) {
35
+ return {
36
+ modelSpec: pick.modelSpec,
37
+ reason: pick.reason,
38
+ record: {
39
+ modelSpec: pick.modelSpec,
40
+ reason: pick.reason,
41
+ ranked: pick.ranked,
42
+ served: served.map((endpoint) => ({
43
+ endpoint: endpoint.name,
44
+ models: [...endpoint.models],
45
+ })),
46
+ hardware: { totalRamGb: profile.totalRamGb, appleSilicon: profile.appleSilicon },
47
+ shortlistRevision: shortlist.revision,
48
+ },
49
+ };
50
+ }
51
+ }
52
+ if (pinned !== null) {
53
+ const reason = `no local model is served here, and a ${pinned.provider} key is set`;
54
+ return {
55
+ modelSpec: pinned.modelSpec,
56
+ reason,
57
+ record: {
58
+ modelSpec: pinned.modelSpec,
59
+ reason,
60
+ ranked: false,
61
+ served: served.map((endpoint) => ({
62
+ endpoint: endpoint.name,
63
+ models: [...endpoint.models],
64
+ })),
65
+ hardware: null,
66
+ shortlistRevision: null,
67
+ },
68
+ };
69
+ }
70
+ throw new NoDefaultModelError(served);
71
+ }
72
+ function frontierWithKey(settings) {
73
+ const keyed = {
74
+ anthropic: settings.providerKeys.anthropic,
75
+ openai: settings.providerKeys.openai,
76
+ google: settings.providerKeys.google,
77
+ };
78
+ for (const modelSpec of frontierFallbackOrder) {
79
+ const provider = modelSpec.split(":")[0] ?? "";
80
+ const key = keyed[provider];
81
+ if (key !== undefined && key.length > 0) {
82
+ return { modelSpec, provider };
83
+ }
84
+ }
85
+ return null;
86
+ }
87
+ function systemDependencies(settings) {
88
+ const pinnedUrl = settings.localEndpoint?.url;
89
+ const candidates = pinnedUrl === undefined
90
+ ? undefined
91
+ : [
92
+ {
93
+ name: defaultLocalEndpoints.find((endpoint) => endpoint.baseUrl === pinnedUrl)?.name ??
94
+ "ollama",
95
+ baseUrl: pinnedUrl,
96
+ },
97
+ ];
98
+ return {
99
+ discover: () => discoverLocalEndpoints({
100
+ fetch: (url) => fetch(url, { signal: AbortSignal.timeout(discoveryTimeoutMs) }),
101
+ ...(candidates === undefined ? {} : { candidates }),
102
+ }),
103
+ probe: () => probeHardware(systemProbeEnvironment()),
104
+ shortlist: readBundledShortlist,
105
+ };
106
+ }
107
+ //# sourceMappingURL=cli-model-default.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-model-default.js","sourceRoot":"","sources":["../src/cli-model-default.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import { servedModelsTimeoutMs } from "./cli-select.js";
2
+ import { fetchServedModels } from "./providers/served-models.js";
3
+ import { preflightLocalModels, preflightRecord, } from "./select/model-preflight.js";
4
+ /** The whole answer rather than the runnable subset, for the caller that has to choose. */
5
+ export async function preflightAll(evidence, backendUrl, models) {
6
+ const checked = preflightLocalModels({
7
+ requested: models,
8
+ backendUrl,
9
+ list: await fetchServedModels({
10
+ baseUrl: backendUrl,
11
+ fetch: (url, init) => fetch(url, init),
12
+ signal: AbortSignal.timeout(servedModelsTimeoutMs),
13
+ }),
14
+ });
15
+ await evidence.record(preflightRecord(checked));
16
+ return checked;
17
+ }
18
+ //# sourceMappingURL=cli-model-preflight.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-model-preflight.js","sourceRoot":"","sources":["../src/cli-model-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAEL,oBAAoB,EACpB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA0B,EAC1B,UAAkB,EAClB,MAAyB;IAEzB,MAAM,OAAO,GAAG,oBAAoB,CAAC;QACnC,SAAS,EAAE,MAAM;QACjB,UAAU;QACV,IAAI,EAAE,MAAM,iBAAiB,CAAC;YAC5B,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC;YACtC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,qBAAqB,CAAC;SACnD,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC;AACjB,CAAC"}