@herdctl/core 0.0.1

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 (520) hide show
  1. package/.turbo/turbo-build.log +4 -0
  2. package/.turbo/turbo-test.log +219 -0
  3. package/.turbo/turbo-typecheck.log +4 -0
  4. package/coverage/base.css +224 -0
  5. package/coverage/block-navigation.js +87 -0
  6. package/coverage/coverage-final.json +51 -0
  7. package/coverage/favicon.png +0 -0
  8. package/coverage/index.html +251 -0
  9. package/coverage/prettify.css +1 -0
  10. package/coverage/prettify.js +2 -0
  11. package/coverage/sort-arrow-sprite.png +0 -0
  12. package/coverage/sorter.js +210 -0
  13. package/coverage/src/config/index.html +191 -0
  14. package/coverage/src/config/index.ts.html +442 -0
  15. package/coverage/src/config/interpolate.ts.html +652 -0
  16. package/coverage/src/config/loader.ts.html +1501 -0
  17. package/coverage/src/config/merge.ts.html +823 -0
  18. package/coverage/src/config/parser.ts.html +1213 -0
  19. package/coverage/src/config/schema.ts.html +1123 -0
  20. package/coverage/src/fleet-manager/errors.ts.html +2326 -0
  21. package/coverage/src/fleet-manager/event-types.ts.html +1219 -0
  22. package/coverage/src/fleet-manager/fleet-manager.ts.html +7030 -0
  23. package/coverage/src/fleet-manager/index.html +206 -0
  24. package/coverage/src/fleet-manager/index.ts.html +469 -0
  25. package/coverage/src/fleet-manager/job-manager.ts.html +2074 -0
  26. package/coverage/src/fleet-manager/job-queue.ts.html +2479 -0
  27. package/coverage/src/fleet-manager/types.ts.html +2602 -0
  28. package/coverage/src/index.html +116 -0
  29. package/coverage/src/index.ts.html +181 -0
  30. package/coverage/src/runner/errors.ts.html +1006 -0
  31. package/coverage/src/runner/index.html +191 -0
  32. package/coverage/src/runner/index.ts.html +256 -0
  33. package/coverage/src/runner/job-executor.ts.html +1429 -0
  34. package/coverage/src/runner/message-processor.ts.html +1150 -0
  35. package/coverage/src/runner/sdk-adapter.ts.html +658 -0
  36. package/coverage/src/runner/types.ts.html +559 -0
  37. package/coverage/src/scheduler/errors.ts.html +388 -0
  38. package/coverage/src/scheduler/index.html +206 -0
  39. package/coverage/src/scheduler/index.ts.html +244 -0
  40. package/coverage/src/scheduler/interval.ts.html +652 -0
  41. package/coverage/src/scheduler/schedule-runner.ts.html +1411 -0
  42. package/coverage/src/scheduler/schedule-state.ts.html +718 -0
  43. package/coverage/src/scheduler/scheduler.ts.html +1795 -0
  44. package/coverage/src/scheduler/types.ts.html +733 -0
  45. package/coverage/src/state/directory.ts.html +736 -0
  46. package/coverage/src/state/errors.ts.html +376 -0
  47. package/coverage/src/state/fleet-state.ts.html +937 -0
  48. package/coverage/src/state/index.html +221 -0
  49. package/coverage/src/state/index.ts.html +322 -0
  50. package/coverage/src/state/job-metadata.ts.html +1420 -0
  51. package/coverage/src/state/job-output.ts.html +1033 -0
  52. package/coverage/src/state/schemas/fleet-state.ts.html +445 -0
  53. package/coverage/src/state/schemas/index.html +176 -0
  54. package/coverage/src/state/schemas/index.ts.html +286 -0
  55. package/coverage/src/state/schemas/job-metadata.ts.html +628 -0
  56. package/coverage/src/state/schemas/job-output.ts.html +616 -0
  57. package/coverage/src/state/schemas/session-info.ts.html +361 -0
  58. package/coverage/src/state/session.ts.html +844 -0
  59. package/coverage/src/state/types.ts.html +262 -0
  60. package/coverage/src/state/utils/atomic.ts.html +748 -0
  61. package/coverage/src/state/utils/index.html +146 -0
  62. package/coverage/src/state/utils/index.ts.html +103 -0
  63. package/coverage/src/state/utils/reads.ts.html +1621 -0
  64. package/coverage/src/work-sources/adapters/github.ts.html +3583 -0
  65. package/coverage/src/work-sources/adapters/index.html +131 -0
  66. package/coverage/src/work-sources/adapters/index.ts.html +277 -0
  67. package/coverage/src/work-sources/errors.ts.html +298 -0
  68. package/coverage/src/work-sources/index.html +176 -0
  69. package/coverage/src/work-sources/index.ts.html +529 -0
  70. package/coverage/src/work-sources/manager.ts.html +1324 -0
  71. package/coverage/src/work-sources/registry.ts.html +619 -0
  72. package/coverage/src/work-sources/types.ts.html +568 -0
  73. package/dist/config/__tests__/agent.test.d.ts +2 -0
  74. package/dist/config/__tests__/agent.test.d.ts.map +1 -0
  75. package/dist/config/__tests__/agent.test.js +752 -0
  76. package/dist/config/__tests__/agent.test.js.map +1 -0
  77. package/dist/config/__tests__/interpolate.test.d.ts +2 -0
  78. package/dist/config/__tests__/interpolate.test.d.ts.map +1 -0
  79. package/dist/config/__tests__/interpolate.test.js +509 -0
  80. package/dist/config/__tests__/interpolate.test.js.map +1 -0
  81. package/dist/config/__tests__/loader.test.d.ts +2 -0
  82. package/dist/config/__tests__/loader.test.d.ts.map +1 -0
  83. package/dist/config/__tests__/loader.test.js +631 -0
  84. package/dist/config/__tests__/loader.test.js.map +1 -0
  85. package/dist/config/__tests__/merge.test.d.ts +2 -0
  86. package/dist/config/__tests__/merge.test.d.ts.map +1 -0
  87. package/dist/config/__tests__/merge.test.js +672 -0
  88. package/dist/config/__tests__/merge.test.js.map +1 -0
  89. package/dist/config/__tests__/parser.test.d.ts +2 -0
  90. package/dist/config/__tests__/parser.test.d.ts.map +1 -0
  91. package/dist/config/__tests__/parser.test.js +476 -0
  92. package/dist/config/__tests__/parser.test.js.map +1 -0
  93. package/dist/config/__tests__/schema.test.d.ts +2 -0
  94. package/dist/config/__tests__/schema.test.d.ts.map +1 -0
  95. package/dist/config/__tests__/schema.test.js +776 -0
  96. package/dist/config/__tests__/schema.test.js.map +1 -0
  97. package/dist/config/index.d.ts +11 -0
  98. package/dist/config/index.d.ts.map +1 -0
  99. package/dist/config/index.js +26 -0
  100. package/dist/config/index.js.map +1 -0
  101. package/dist/config/interpolate.d.ts +76 -0
  102. package/dist/config/interpolate.d.ts.map +1 -0
  103. package/dist/config/interpolate.js +143 -0
  104. package/dist/config/interpolate.js.map +1 -0
  105. package/dist/config/loader.d.ts +147 -0
  106. package/dist/config/loader.d.ts.map +1 -0
  107. package/dist/config/loader.js +336 -0
  108. package/dist/config/loader.js.map +1 -0
  109. package/dist/config/merge.d.ts +84 -0
  110. package/dist/config/merge.d.ts.map +1 -0
  111. package/dist/config/merge.js +138 -0
  112. package/dist/config/merge.js.map +1 -0
  113. package/dist/config/parser.d.ts +143 -0
  114. package/dist/config/parser.d.ts.map +1 -0
  115. package/dist/config/parser.js +316 -0
  116. package/dist/config/parser.js.map +1 -0
  117. package/dist/config/schema.d.ts +1906 -0
  118. package/dist/config/schema.d.ts.map +1 -0
  119. package/dist/config/schema.js +268 -0
  120. package/dist/config/schema.js.map +1 -0
  121. package/dist/fleet-manager/__tests__/coverage.test.d.ts +13 -0
  122. package/dist/fleet-manager/__tests__/coverage.test.d.ts.map +1 -0
  123. package/dist/fleet-manager/__tests__/coverage.test.js +2282 -0
  124. package/dist/fleet-manager/__tests__/coverage.test.js.map +1 -0
  125. package/dist/fleet-manager/__tests__/errors.test.d.ts +7 -0
  126. package/dist/fleet-manager/__tests__/errors.test.d.ts.map +1 -0
  127. package/dist/fleet-manager/__tests__/errors.test.js +557 -0
  128. package/dist/fleet-manager/__tests__/errors.test.js.map +1 -0
  129. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts +7 -0
  130. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts.map +1 -0
  131. package/dist/fleet-manager/__tests__/event-helpers.test.js +368 -0
  132. package/dist/fleet-manager/__tests__/event-helpers.test.js.map +1 -0
  133. package/dist/fleet-manager/__tests__/integration.test.d.ts +11 -0
  134. package/dist/fleet-manager/__tests__/integration.test.d.ts.map +1 -0
  135. package/dist/fleet-manager/__tests__/integration.test.js +949 -0
  136. package/dist/fleet-manager/__tests__/integration.test.js.map +1 -0
  137. package/dist/fleet-manager/__tests__/job-control.test.d.ts +7 -0
  138. package/dist/fleet-manager/__tests__/job-control.test.d.ts.map +1 -0
  139. package/dist/fleet-manager/__tests__/job-control.test.js +215 -0
  140. package/dist/fleet-manager/__tests__/job-control.test.js.map +1 -0
  141. package/dist/fleet-manager/__tests__/job-manager.test.d.ts +7 -0
  142. package/dist/fleet-manager/__tests__/job-manager.test.d.ts.map +1 -0
  143. package/dist/fleet-manager/__tests__/job-manager.test.js +659 -0
  144. package/dist/fleet-manager/__tests__/job-manager.test.js.map +1 -0
  145. package/dist/fleet-manager/__tests__/job-queue.test.d.ts +5 -0
  146. package/dist/fleet-manager/__tests__/job-queue.test.d.ts.map +1 -0
  147. package/dist/fleet-manager/__tests__/job-queue.test.js +315 -0
  148. package/dist/fleet-manager/__tests__/job-queue.test.js.map +1 -0
  149. package/dist/fleet-manager/__tests__/reload.test.d.ts +7 -0
  150. package/dist/fleet-manager/__tests__/reload.test.d.ts.map +1 -0
  151. package/dist/fleet-manager/__tests__/reload.test.js +609 -0
  152. package/dist/fleet-manager/__tests__/reload.test.js.map +1 -0
  153. package/dist/fleet-manager/__tests__/status-queries.test.d.ts +7 -0
  154. package/dist/fleet-manager/__tests__/status-queries.test.d.ts.map +1 -0
  155. package/dist/fleet-manager/__tests__/status-queries.test.js +488 -0
  156. package/dist/fleet-manager/__tests__/status-queries.test.js.map +1 -0
  157. package/dist/fleet-manager/__tests__/trigger.test.d.ts +7 -0
  158. package/dist/fleet-manager/__tests__/trigger.test.d.ts.map +1 -0
  159. package/dist/fleet-manager/__tests__/trigger.test.js +471 -0
  160. package/dist/fleet-manager/__tests__/trigger.test.js.map +1 -0
  161. package/dist/fleet-manager/errors.d.ts +407 -0
  162. package/dist/fleet-manager/errors.d.ts.map +1 -0
  163. package/dist/fleet-manager/errors.js +569 -0
  164. package/dist/fleet-manager/errors.js.map +1 -0
  165. package/dist/fleet-manager/event-types.d.ts +302 -0
  166. package/dist/fleet-manager/event-types.d.ts.map +1 -0
  167. package/dist/fleet-manager/event-types.js +9 -0
  168. package/dist/fleet-manager/event-types.js.map +1 -0
  169. package/dist/fleet-manager/fleet-manager.d.ts +699 -0
  170. package/dist/fleet-manager/fleet-manager.d.ts.map +1 -0
  171. package/dist/fleet-manager/fleet-manager.js +1906 -0
  172. package/dist/fleet-manager/fleet-manager.js.map +1 -0
  173. package/dist/fleet-manager/index.d.ts +17 -0
  174. package/dist/fleet-manager/index.d.ts.map +1 -0
  175. package/dist/fleet-manager/index.js +29 -0
  176. package/dist/fleet-manager/index.js.map +1 -0
  177. package/dist/fleet-manager/job-manager.d.ts +271 -0
  178. package/dist/fleet-manager/job-manager.d.ts.map +1 -0
  179. package/dist/fleet-manager/job-manager.js +443 -0
  180. package/dist/fleet-manager/job-manager.js.map +1 -0
  181. package/dist/fleet-manager/job-queue.d.ts +422 -0
  182. package/dist/fleet-manager/job-queue.d.ts.map +1 -0
  183. package/dist/fleet-manager/job-queue.js +448 -0
  184. package/dist/fleet-manager/job-queue.js.map +1 -0
  185. package/dist/fleet-manager/types.d.ts +680 -0
  186. package/dist/fleet-manager/types.d.ts.map +1 -0
  187. package/dist/fleet-manager/types.js +8 -0
  188. package/dist/fleet-manager/types.js.map +1 -0
  189. package/dist/index.d.ts +20 -0
  190. package/dist/index.d.ts.map +1 -0
  191. package/dist/index.js +26 -0
  192. package/dist/index.js.map +1 -0
  193. package/dist/runner/__tests__/errors.test.d.ts +2 -0
  194. package/dist/runner/__tests__/errors.test.d.ts.map +1 -0
  195. package/dist/runner/__tests__/errors.test.js +264 -0
  196. package/dist/runner/__tests__/errors.test.js.map +1 -0
  197. package/dist/runner/__tests__/job-executor.test.d.ts +2 -0
  198. package/dist/runner/__tests__/job-executor.test.d.ts.map +1 -0
  199. package/dist/runner/__tests__/job-executor.test.js +1345 -0
  200. package/dist/runner/__tests__/job-executor.test.js.map +1 -0
  201. package/dist/runner/__tests__/message-processor.test.d.ts +2 -0
  202. package/dist/runner/__tests__/message-processor.test.d.ts.map +1 -0
  203. package/dist/runner/__tests__/message-processor.test.js +768 -0
  204. package/dist/runner/__tests__/message-processor.test.js.map +1 -0
  205. package/dist/runner/__tests__/sdk-adapter.test.d.ts +2 -0
  206. package/dist/runner/__tests__/sdk-adapter.test.d.ts.map +1 -0
  207. package/dist/runner/__tests__/sdk-adapter.test.js +554 -0
  208. package/dist/runner/__tests__/sdk-adapter.test.js.map +1 -0
  209. package/dist/runner/errors.d.ts +121 -0
  210. package/dist/runner/errors.d.ts.map +1 -0
  211. package/dist/runner/errors.js +212 -0
  212. package/dist/runner/errors.js.map +1 -0
  213. package/dist/runner/index.d.ts +12 -0
  214. package/dist/runner/index.d.ts.map +1 -0
  215. package/dist/runner/index.js +15 -0
  216. package/dist/runner/index.js.map +1 -0
  217. package/dist/runner/job-executor.d.ts +98 -0
  218. package/dist/runner/job-executor.d.ts.map +1 -0
  219. package/dist/runner/job-executor.js +333 -0
  220. package/dist/runner/job-executor.js.map +1 -0
  221. package/dist/runner/message-processor.d.ts +45 -0
  222. package/dist/runner/message-processor.d.ts.map +1 -0
  223. package/dist/runner/message-processor.js +294 -0
  224. package/dist/runner/message-processor.js.map +1 -0
  225. package/dist/runner/sdk-adapter.d.ts +60 -0
  226. package/dist/runner/sdk-adapter.d.ts.map +1 -0
  227. package/dist/runner/sdk-adapter.js +138 -0
  228. package/dist/runner/sdk-adapter.js.map +1 -0
  229. package/dist/runner/types.d.ts +135 -0
  230. package/dist/runner/types.d.ts.map +1 -0
  231. package/dist/runner/types.js +7 -0
  232. package/dist/runner/types.js.map +1 -0
  233. package/dist/scheduler/__tests__/errors.test.d.ts +2 -0
  234. package/dist/scheduler/__tests__/errors.test.d.ts.map +1 -0
  235. package/dist/scheduler/__tests__/errors.test.js +101 -0
  236. package/dist/scheduler/__tests__/errors.test.js.map +1 -0
  237. package/dist/scheduler/__tests__/interval.test.d.ts +2 -0
  238. package/dist/scheduler/__tests__/interval.test.d.ts.map +1 -0
  239. package/dist/scheduler/__tests__/interval.test.js +419 -0
  240. package/dist/scheduler/__tests__/interval.test.js.map +1 -0
  241. package/dist/scheduler/__tests__/schedule-runner.test.d.ts +2 -0
  242. package/dist/scheduler/__tests__/schedule-runner.test.d.ts.map +1 -0
  243. package/dist/scheduler/__tests__/schedule-runner.test.js +634 -0
  244. package/dist/scheduler/__tests__/schedule-runner.test.js.map +1 -0
  245. package/dist/scheduler/__tests__/schedule-state.test.d.ts +2 -0
  246. package/dist/scheduler/__tests__/schedule-state.test.d.ts.map +1 -0
  247. package/dist/scheduler/__tests__/schedule-state.test.js +572 -0
  248. package/dist/scheduler/__tests__/schedule-state.test.js.map +1 -0
  249. package/dist/scheduler/__tests__/scheduler.test.d.ts +2 -0
  250. package/dist/scheduler/__tests__/scheduler.test.d.ts.map +1 -0
  251. package/dist/scheduler/__tests__/scheduler.test.js +987 -0
  252. package/dist/scheduler/__tests__/scheduler.test.js.map +1 -0
  253. package/dist/scheduler/errors.d.ts +61 -0
  254. package/dist/scheduler/errors.d.ts.map +1 -0
  255. package/dist/scheduler/errors.js +81 -0
  256. package/dist/scheduler/errors.js.map +1 -0
  257. package/dist/scheduler/index.d.ts +13 -0
  258. package/dist/scheduler/index.d.ts.map +1 -0
  259. package/dist/scheduler/index.js +17 -0
  260. package/dist/scheduler/index.js.map +1 -0
  261. package/dist/scheduler/interval.d.ts +64 -0
  262. package/dist/scheduler/interval.d.ts.map +1 -0
  263. package/dist/scheduler/interval.js +139 -0
  264. package/dist/scheduler/interval.js.map +1 -0
  265. package/dist/scheduler/schedule-runner.d.ts +149 -0
  266. package/dist/scheduler/schedule-runner.d.ts.map +1 -0
  267. package/dist/scheduler/schedule-runner.js +277 -0
  268. package/dist/scheduler/schedule-runner.js.map +1 -0
  269. package/dist/scheduler/schedule-state.d.ts +105 -0
  270. package/dist/scheduler/schedule-state.d.ts.map +1 -0
  271. package/dist/scheduler/schedule-state.js +151 -0
  272. package/dist/scheduler/schedule-state.js.map +1 -0
  273. package/dist/scheduler/scheduler.d.ts +138 -0
  274. package/dist/scheduler/scheduler.d.ts.map +1 -0
  275. package/dist/scheduler/scheduler.js +423 -0
  276. package/dist/scheduler/scheduler.js.map +1 -0
  277. package/dist/scheduler/types.d.ts +160 -0
  278. package/dist/scheduler/types.d.ts.map +1 -0
  279. package/dist/scheduler/types.js +8 -0
  280. package/dist/scheduler/types.js.map +1 -0
  281. package/dist/state/__tests__/directory.test.d.ts +2 -0
  282. package/dist/state/__tests__/directory.test.d.ts.map +1 -0
  283. package/dist/state/__tests__/directory.test.js +414 -0
  284. package/dist/state/__tests__/directory.test.js.map +1 -0
  285. package/dist/state/__tests__/fleet-state.test.d.ts +2 -0
  286. package/dist/state/__tests__/fleet-state.test.d.ts.map +1 -0
  287. package/dist/state/__tests__/fleet-state.test.js +696 -0
  288. package/dist/state/__tests__/fleet-state.test.js.map +1 -0
  289. package/dist/state/__tests__/job-metadata-schema.test.d.ts +2 -0
  290. package/dist/state/__tests__/job-metadata-schema.test.d.ts.map +1 -0
  291. package/dist/state/__tests__/job-metadata-schema.test.js +329 -0
  292. package/dist/state/__tests__/job-metadata-schema.test.js.map +1 -0
  293. package/dist/state/__tests__/job-metadata.test.d.ts +2 -0
  294. package/dist/state/__tests__/job-metadata.test.d.ts.map +1 -0
  295. package/dist/state/__tests__/job-metadata.test.js +667 -0
  296. package/dist/state/__tests__/job-metadata.test.js.map +1 -0
  297. package/dist/state/__tests__/job-output.test.d.ts +2 -0
  298. package/dist/state/__tests__/job-output.test.d.ts.map +1 -0
  299. package/dist/state/__tests__/job-output.test.js +672 -0
  300. package/dist/state/__tests__/job-output.test.js.map +1 -0
  301. package/dist/state/__tests__/session-schema.test.d.ts +2 -0
  302. package/dist/state/__tests__/session-schema.test.d.ts.map +1 -0
  303. package/dist/state/__tests__/session-schema.test.js +323 -0
  304. package/dist/state/__tests__/session-schema.test.js.map +1 -0
  305. package/dist/state/__tests__/session.test.d.ts +2 -0
  306. package/dist/state/__tests__/session.test.d.ts.map +1 -0
  307. package/dist/state/__tests__/session.test.js +468 -0
  308. package/dist/state/__tests__/session.test.js.map +1 -0
  309. package/dist/state/directory.d.ts +42 -0
  310. package/dist/state/directory.d.ts.map +1 -0
  311. package/dist/state/directory.js +170 -0
  312. package/dist/state/directory.js.map +1 -0
  313. package/dist/state/errors.d.ts +44 -0
  314. package/dist/state/errors.d.ts.map +1 -0
  315. package/dist/state/errors.js +82 -0
  316. package/dist/state/errors.js.map +1 -0
  317. package/dist/state/fleet-state.d.ts +126 -0
  318. package/dist/state/fleet-state.d.ts.map +1 -0
  319. package/dist/state/fleet-state.js +196 -0
  320. package/dist/state/fleet-state.js.map +1 -0
  321. package/dist/state/index.d.ts +21 -0
  322. package/dist/state/index.d.ts.map +1 -0
  323. package/dist/state/index.js +30 -0
  324. package/dist/state/index.js.map +1 -0
  325. package/dist/state/job-metadata.d.ts +151 -0
  326. package/dist/state/job-metadata.d.ts.map +1 -0
  327. package/dist/state/job-metadata.js +287 -0
  328. package/dist/state/job-metadata.js.map +1 -0
  329. package/dist/state/job-output.d.ts +116 -0
  330. package/dist/state/job-output.d.ts.map +1 -0
  331. package/dist/state/job-output.js +218 -0
  332. package/dist/state/job-output.js.map +1 -0
  333. package/dist/state/schemas/__tests__/job-output.test.d.ts +2 -0
  334. package/dist/state/schemas/__tests__/job-output.test.d.ts.map +1 -0
  335. package/dist/state/schemas/__tests__/job-output.test.js +279 -0
  336. package/dist/state/schemas/__tests__/job-output.test.js.map +1 -0
  337. package/dist/state/schemas/fleet-state.d.ts +249 -0
  338. package/dist/state/schemas/fleet-state.d.ts.map +1 -0
  339. package/dist/state/schemas/fleet-state.js +97 -0
  340. package/dist/state/schemas/fleet-state.js.map +1 -0
  341. package/dist/state/schemas/index.d.ts +10 -0
  342. package/dist/state/schemas/index.d.ts.map +1 -0
  343. package/dist/state/schemas/index.js +10 -0
  344. package/dist/state/schemas/index.js.map +1 -0
  345. package/dist/state/schemas/job-metadata.d.ts +118 -0
  346. package/dist/state/schemas/job-metadata.d.ts.map +1 -0
  347. package/dist/state/schemas/job-metadata.js +123 -0
  348. package/dist/state/schemas/job-metadata.js.map +1 -0
  349. package/dist/state/schemas/job-output.d.ts +291 -0
  350. package/dist/state/schemas/job-output.d.ts.map +1 -0
  351. package/dist/state/schemas/job-output.js +132 -0
  352. package/dist/state/schemas/job-output.js.map +1 -0
  353. package/dist/state/schemas/session-info.d.ts +65 -0
  354. package/dist/state/schemas/session-info.d.ts.map +1 -0
  355. package/dist/state/schemas/session-info.js +58 -0
  356. package/dist/state/schemas/session-info.js.map +1 -0
  357. package/dist/state/session.d.ts +92 -0
  358. package/dist/state/session.d.ts.map +1 -0
  359. package/dist/state/session.js +173 -0
  360. package/dist/state/session.js.map +1 -0
  361. package/dist/state/types.d.ts +54 -0
  362. package/dist/state/types.d.ts.map +1 -0
  363. package/dist/state/types.js +18 -0
  364. package/dist/state/types.js.map +1 -0
  365. package/dist/state/utils/__tests__/atomic.test.d.ts +2 -0
  366. package/dist/state/utils/__tests__/atomic.test.d.ts.map +1 -0
  367. package/dist/state/utils/__tests__/atomic.test.js +537 -0
  368. package/dist/state/utils/__tests__/atomic.test.js.map +1 -0
  369. package/dist/state/utils/__tests__/reads.test.d.ts +2 -0
  370. package/dist/state/utils/__tests__/reads.test.d.ts.map +1 -0
  371. package/dist/state/utils/__tests__/reads.test.js +792 -0
  372. package/dist/state/utils/__tests__/reads.test.js.map +1 -0
  373. package/dist/state/utils/atomic.d.ts +89 -0
  374. package/dist/state/utils/atomic.d.ts.map +1 -0
  375. package/dist/state/utils/atomic.js +157 -0
  376. package/dist/state/utils/atomic.js.map +1 -0
  377. package/dist/state/utils/index.d.ts +6 -0
  378. package/dist/state/utils/index.d.ts.map +1 -0
  379. package/dist/state/utils/index.js +6 -0
  380. package/dist/state/utils/index.js.map +1 -0
  381. package/dist/state/utils/reads.d.ts +196 -0
  382. package/dist/state/utils/reads.d.ts.map +1 -0
  383. package/dist/state/utils/reads.js +346 -0
  384. package/dist/state/utils/reads.js.map +1 -0
  385. package/dist/work-sources/__tests__/github.test.d.ts +2 -0
  386. package/dist/work-sources/__tests__/github.test.d.ts.map +1 -0
  387. package/dist/work-sources/__tests__/github.test.js +1334 -0
  388. package/dist/work-sources/__tests__/github.test.js.map +1 -0
  389. package/dist/work-sources/__tests__/manager.test.d.ts +2 -0
  390. package/dist/work-sources/__tests__/manager.test.d.ts.map +1 -0
  391. package/dist/work-sources/__tests__/manager.test.js +424 -0
  392. package/dist/work-sources/__tests__/manager.test.js.map +1 -0
  393. package/dist/work-sources/__tests__/registry.test.d.ts +2 -0
  394. package/dist/work-sources/__tests__/registry.test.d.ts.map +1 -0
  395. package/dist/work-sources/__tests__/registry.test.js +381 -0
  396. package/dist/work-sources/__tests__/registry.test.js.map +1 -0
  397. package/dist/work-sources/__tests__/types.test.d.ts +2 -0
  398. package/dist/work-sources/__tests__/types.test.d.ts.map +1 -0
  399. package/dist/work-sources/__tests__/types.test.js +406 -0
  400. package/dist/work-sources/__tests__/types.test.js.map +1 -0
  401. package/dist/work-sources/adapters/github.d.ts +290 -0
  402. package/dist/work-sources/adapters/github.d.ts.map +1 -0
  403. package/dist/work-sources/adapters/github.js +803 -0
  404. package/dist/work-sources/adapters/github.js.map +1 -0
  405. package/dist/work-sources/adapters/index.d.ts +10 -0
  406. package/dist/work-sources/adapters/index.d.ts.map +1 -0
  407. package/dist/work-sources/adapters/index.js +31 -0
  408. package/dist/work-sources/adapters/index.js.map +1 -0
  409. package/dist/work-sources/errors.d.ts +40 -0
  410. package/dist/work-sources/errors.d.ts.map +1 -0
  411. package/dist/work-sources/errors.js +54 -0
  412. package/dist/work-sources/errors.js.map +1 -0
  413. package/dist/work-sources/index.d.ts +105 -0
  414. package/dist/work-sources/index.d.ts.map +1 -0
  415. package/dist/work-sources/index.js +24 -0
  416. package/dist/work-sources/index.js.map +1 -0
  417. package/dist/work-sources/manager.d.ts +370 -0
  418. package/dist/work-sources/manager.d.ts.map +1 -0
  419. package/dist/work-sources/manager.js +61 -0
  420. package/dist/work-sources/manager.js.map +1 -0
  421. package/dist/work-sources/registry.d.ts +128 -0
  422. package/dist/work-sources/registry.d.ts.map +1 -0
  423. package/dist/work-sources/registry.js +132 -0
  424. package/dist/work-sources/registry.js.map +1 -0
  425. package/dist/work-sources/types.d.ts +127 -0
  426. package/dist/work-sources/types.d.ts.map +1 -0
  427. package/dist/work-sources/types.js +8 -0
  428. package/dist/work-sources/types.js.map +1 -0
  429. package/package.json +23 -0
  430. package/src/config/__tests__/agent.test.ts +864 -0
  431. package/src/config/__tests__/interpolate.test.ts +644 -0
  432. package/src/config/__tests__/loader.test.ts +784 -0
  433. package/src/config/__tests__/merge.test.ts +751 -0
  434. package/src/config/__tests__/parser.test.ts +533 -0
  435. package/src/config/__tests__/schema.test.ts +873 -0
  436. package/src/config/index.ts +119 -0
  437. package/src/config/interpolate.ts +189 -0
  438. package/src/config/loader.ts +472 -0
  439. package/src/config/merge.ts +246 -0
  440. package/src/config/parser.ts +376 -0
  441. package/src/config/schema.ts +346 -0
  442. package/src/fleet-manager/__tests__/coverage.test.ts +2869 -0
  443. package/src/fleet-manager/__tests__/errors.test.ts +660 -0
  444. package/src/fleet-manager/__tests__/event-helpers.test.ts +448 -0
  445. package/src/fleet-manager/__tests__/integration.test.ts +1209 -0
  446. package/src/fleet-manager/__tests__/job-control.test.ts +283 -0
  447. package/src/fleet-manager/__tests__/job-manager.test.ts +869 -0
  448. package/src/fleet-manager/__tests__/job-queue.test.ts +401 -0
  449. package/src/fleet-manager/__tests__/reload.test.ts +751 -0
  450. package/src/fleet-manager/__tests__/status-queries.test.ts +595 -0
  451. package/src/fleet-manager/__tests__/trigger.test.ts +601 -0
  452. package/src/fleet-manager/errors.ts +747 -0
  453. package/src/fleet-manager/event-types.ts +378 -0
  454. package/src/fleet-manager/fleet-manager.ts +2315 -0
  455. package/src/fleet-manager/index.ts +128 -0
  456. package/src/fleet-manager/job-manager.ts +663 -0
  457. package/src/fleet-manager/job-queue.ts +798 -0
  458. package/src/fleet-manager/types.ts +839 -0
  459. package/src/index.ts +32 -0
  460. package/src/runner/__tests__/errors.test.ts +382 -0
  461. package/src/runner/__tests__/job-executor.test.ts +1708 -0
  462. package/src/runner/__tests__/message-processor.test.ts +960 -0
  463. package/src/runner/__tests__/sdk-adapter.test.ts +626 -0
  464. package/src/runner/errors.ts +307 -0
  465. package/src/runner/index.ts +57 -0
  466. package/src/runner/job-executor.ts +448 -0
  467. package/src/runner/message-processor.ts +355 -0
  468. package/src/runner/sdk-adapter.ts +191 -0
  469. package/src/runner/types.ts +158 -0
  470. package/src/scheduler/__tests__/errors.test.ts +159 -0
  471. package/src/scheduler/__tests__/interval.test.ts +515 -0
  472. package/src/scheduler/__tests__/schedule-runner.test.ts +798 -0
  473. package/src/scheduler/__tests__/schedule-state.test.ts +671 -0
  474. package/src/scheduler/__tests__/scheduler.test.ts +1280 -0
  475. package/src/scheduler/errors.ts +101 -0
  476. package/src/scheduler/index.ts +53 -0
  477. package/src/scheduler/interval.ts +189 -0
  478. package/src/scheduler/schedule-runner.ts +442 -0
  479. package/src/scheduler/schedule-state.ts +211 -0
  480. package/src/scheduler/scheduler.ts +570 -0
  481. package/src/scheduler/types.ts +216 -0
  482. package/src/state/__tests__/directory.test.ts +595 -0
  483. package/src/state/__tests__/fleet-state.test.ts +868 -0
  484. package/src/state/__tests__/job-metadata-schema.test.ts +414 -0
  485. package/src/state/__tests__/job-metadata.test.ts +831 -0
  486. package/src/state/__tests__/job-output.test.ts +856 -0
  487. package/src/state/__tests__/session-schema.test.ts +378 -0
  488. package/src/state/__tests__/session.test.ts +604 -0
  489. package/src/state/directory.ts +217 -0
  490. package/src/state/errors.ts +97 -0
  491. package/src/state/fleet-state.ts +284 -0
  492. package/src/state/index.ts +79 -0
  493. package/src/state/job-metadata.ts +445 -0
  494. package/src/state/job-output.ts +316 -0
  495. package/src/state/schemas/__tests__/job-output.test.ts +338 -0
  496. package/src/state/schemas/fleet-state.ts +120 -0
  497. package/src/state/schemas/index.ts +67 -0
  498. package/src/state/schemas/job-metadata.ts +181 -0
  499. package/src/state/schemas/job-output.ts +177 -0
  500. package/src/state/schemas/session-info.ts +92 -0
  501. package/src/state/session.ts +253 -0
  502. package/src/state/types.ts +59 -0
  503. package/src/state/utils/__tests__/atomic.test.ts +723 -0
  504. package/src/state/utils/__tests__/reads.test.ts +1071 -0
  505. package/src/state/utils/atomic.ts +221 -0
  506. package/src/state/utils/index.ts +6 -0
  507. package/src/state/utils/reads.ts +512 -0
  508. package/src/work-sources/__tests__/github.test.ts +1800 -0
  509. package/src/work-sources/__tests__/manager.test.ts +529 -0
  510. package/src/work-sources/__tests__/registry.test.ts +477 -0
  511. package/src/work-sources/__tests__/types.test.ts +479 -0
  512. package/src/work-sources/adapters/github.ts +1166 -0
  513. package/src/work-sources/adapters/index.ts +64 -0
  514. package/src/work-sources/errors.ts +71 -0
  515. package/src/work-sources/index.ts +148 -0
  516. package/src/work-sources/manager.ts +413 -0
  517. package/src/work-sources/registry.ts +178 -0
  518. package/src/work-sources/types.ts +161 -0
  519. package/tsconfig.json +9 -0
  520. package/vitest.config.ts +19 -0
@@ -0,0 +1,752 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
+ import { writeFile, mkdir, rm } from "node:fs/promises";
3
+ import { join } from "node:path";
4
+ import { tmpdir } from "node:os";
5
+ import { parseAgentConfig, validateAgentConfig, safeParseAgentConfig, loadAgentConfig, resolveAgentPath, AgentValidationError, AgentYamlSyntaxError, FileReadError, } from "../parser.js";
6
+ import { AgentConfigSchema, IdentitySchema, SessionSchema, ScheduleSchema, McpServerSchema, AgentChatSchema, } from "../schema.js";
7
+ describe("AgentConfigSchema", () => {
8
+ it("validates minimal agent config with just name", () => {
9
+ const result = AgentConfigSchema.safeParse({ name: "test-agent" });
10
+ expect(result.success).toBe(true);
11
+ if (result.success) {
12
+ expect(result.data.name).toBe("test-agent");
13
+ }
14
+ });
15
+ it("validates complete agent config with all fields", () => {
16
+ const config = {
17
+ name: "bragdoc-coder",
18
+ description: "A coding assistant agent",
19
+ workspace: "/home/agent/workspace",
20
+ repo: "https://github.com/example/repo",
21
+ identity: {
22
+ name: "Cody",
23
+ role: "developer",
24
+ personality: "helpful and concise",
25
+ },
26
+ system_prompt: "You are a helpful coding assistant.",
27
+ work_source: {
28
+ type: "github",
29
+ labels: {
30
+ ready: "ready",
31
+ in_progress: "in-progress",
32
+ },
33
+ cleanup_in_progress: true,
34
+ },
35
+ schedules: {
36
+ main: {
37
+ type: "interval",
38
+ interval: "5m",
39
+ prompt: "Check for new issues",
40
+ },
41
+ daily: {
42
+ type: "cron",
43
+ expression: "0 9 * * *",
44
+ prompt: "Daily check",
45
+ },
46
+ },
47
+ session: {
48
+ max_turns: 50,
49
+ timeout: "30m",
50
+ model: "claude-sonnet-4-20250514",
51
+ },
52
+ permissions: {
53
+ mode: "acceptEdits",
54
+ allowed_tools: ["Read", "Edit", "Write", "Bash"],
55
+ denied_tools: ["WebSearch"],
56
+ bash: {
57
+ allowed_commands: ["git", "npm"],
58
+ denied_patterns: ["rm -rf /"],
59
+ },
60
+ },
61
+ mcp_servers: {
62
+ github: {
63
+ command: "npx",
64
+ args: ["-y", "@modelcontextprotocol/server-github"],
65
+ env: {
66
+ GITHUB_TOKEN: "${GITHUB_TOKEN}",
67
+ },
68
+ },
69
+ filesystem: {
70
+ url: "http://localhost:3000/mcp",
71
+ },
72
+ },
73
+ chat: {
74
+ discord: {
75
+ channel_ids: ["123456789", "987654321"],
76
+ respond_to_mentions: true,
77
+ },
78
+ },
79
+ model: "claude-sonnet-4-20250514",
80
+ max_turns: 100,
81
+ permission_mode: "bypassPermissions",
82
+ };
83
+ const result = AgentConfigSchema.safeParse(config);
84
+ expect(result.success).toBe(true);
85
+ if (result.success) {
86
+ expect(result.data.name).toBe("bragdoc-coder");
87
+ expect(result.data.description).toBe("A coding assistant agent");
88
+ expect(result.data.identity?.name).toBe("Cody");
89
+ expect(result.data.schedules?.main.type).toBe("interval");
90
+ expect(result.data.schedules?.daily.type).toBe("cron");
91
+ expect(result.data.mcp_servers?.github.command).toBe("npx");
92
+ expect(result.data.chat?.discord?.channel_ids).toContain("123456789");
93
+ }
94
+ });
95
+ it("rejects agent config without name", () => {
96
+ const result = AgentConfigSchema.safeParse({
97
+ description: "An agent without a name",
98
+ });
99
+ expect(result.success).toBe(false);
100
+ });
101
+ it("rejects invalid permission mode", () => {
102
+ const result = AgentConfigSchema.safeParse({
103
+ name: "test-agent",
104
+ permission_mode: "invalid-mode",
105
+ });
106
+ expect(result.success).toBe(false);
107
+ });
108
+ it("accepts workspace as string path", () => {
109
+ const result = AgentConfigSchema.safeParse({
110
+ name: "test-agent",
111
+ workspace: "/path/to/workspace",
112
+ });
113
+ expect(result.success).toBe(true);
114
+ if (result.success) {
115
+ expect(result.data.workspace).toBe("/path/to/workspace");
116
+ }
117
+ });
118
+ it("accepts workspace as full workspace object", () => {
119
+ const result = AgentConfigSchema.safeParse({
120
+ name: "test-agent",
121
+ workspace: {
122
+ root: "/path/to/workspace",
123
+ auto_clone: false,
124
+ clone_depth: 5,
125
+ default_branch: "develop",
126
+ },
127
+ });
128
+ expect(result.success).toBe(true);
129
+ if (result.success) {
130
+ const workspace = result.data.workspace;
131
+ expect(typeof workspace).toBe("object");
132
+ if (typeof workspace === "object" && workspace !== null) {
133
+ expect(workspace.root).toBe("/path/to/workspace");
134
+ expect(workspace.auto_clone).toBe(false);
135
+ }
136
+ }
137
+ });
138
+ it("rejects negative max_turns", () => {
139
+ const result = AgentConfigSchema.safeParse({
140
+ name: "test-agent",
141
+ max_turns: -1,
142
+ });
143
+ expect(result.success).toBe(false);
144
+ });
145
+ it("rejects non-integer max_turns", () => {
146
+ const result = AgentConfigSchema.safeParse({
147
+ name: "test-agent",
148
+ max_turns: 1.5,
149
+ });
150
+ expect(result.success).toBe(false);
151
+ });
152
+ });
153
+ describe("IdentitySchema", () => {
154
+ it("parses empty identity", () => {
155
+ const result = IdentitySchema.safeParse({});
156
+ expect(result.success).toBe(true);
157
+ });
158
+ it("parses complete identity", () => {
159
+ const identity = {
160
+ name: "Claude",
161
+ role: "assistant",
162
+ personality: "helpful and friendly",
163
+ };
164
+ const result = IdentitySchema.safeParse(identity);
165
+ expect(result.success).toBe(true);
166
+ if (result.success) {
167
+ expect(result.data.name).toBe("Claude");
168
+ expect(result.data.role).toBe("assistant");
169
+ expect(result.data.personality).toBe("helpful and friendly");
170
+ }
171
+ });
172
+ });
173
+ describe("SessionSchema", () => {
174
+ it("parses empty session", () => {
175
+ const result = SessionSchema.safeParse({});
176
+ expect(result.success).toBe(true);
177
+ });
178
+ it("parses complete session", () => {
179
+ const session = {
180
+ max_turns: 100,
181
+ timeout: "1h",
182
+ model: "claude-opus-4-20250514",
183
+ };
184
+ const result = SessionSchema.safeParse(session);
185
+ expect(result.success).toBe(true);
186
+ if (result.success) {
187
+ expect(result.data.max_turns).toBe(100);
188
+ expect(result.data.timeout).toBe("1h");
189
+ expect(result.data.model).toBe("claude-opus-4-20250514");
190
+ }
191
+ });
192
+ it("rejects non-positive max_turns", () => {
193
+ const result = SessionSchema.safeParse({ max_turns: 0 });
194
+ expect(result.success).toBe(false);
195
+ });
196
+ });
197
+ describe("ScheduleSchema", () => {
198
+ it("parses interval schedule", () => {
199
+ const schedule = {
200
+ type: "interval",
201
+ interval: "5m",
202
+ prompt: "Check for updates",
203
+ };
204
+ const result = ScheduleSchema.safeParse(schedule);
205
+ expect(result.success).toBe(true);
206
+ if (result.success) {
207
+ expect(result.data.type).toBe("interval");
208
+ expect(result.data.interval).toBe("5m");
209
+ }
210
+ });
211
+ it("parses cron schedule", () => {
212
+ const schedule = {
213
+ type: "cron",
214
+ expression: "0 9 * * 1-5",
215
+ prompt: "Morning check",
216
+ };
217
+ const result = ScheduleSchema.safeParse(schedule);
218
+ expect(result.success).toBe(true);
219
+ if (result.success) {
220
+ expect(result.data.type).toBe("cron");
221
+ expect(result.data.expression).toBe("0 9 * * 1-5");
222
+ }
223
+ });
224
+ it("parses webhook schedule", () => {
225
+ const schedule = {
226
+ type: "webhook",
227
+ prompt: "Handle webhook",
228
+ };
229
+ const result = ScheduleSchema.safeParse(schedule);
230
+ expect(result.success).toBe(true);
231
+ });
232
+ it("parses chat schedule", () => {
233
+ const schedule = {
234
+ type: "chat",
235
+ };
236
+ const result = ScheduleSchema.safeParse(schedule);
237
+ expect(result.success).toBe(true);
238
+ });
239
+ it("parses schedule with work_source override", () => {
240
+ const schedule = {
241
+ type: "interval",
242
+ interval: "10m",
243
+ work_source: {
244
+ type: "github",
245
+ labels: {
246
+ ready: "urgent",
247
+ },
248
+ },
249
+ };
250
+ const result = ScheduleSchema.safeParse(schedule);
251
+ expect(result.success).toBe(true);
252
+ if (result.success) {
253
+ expect(result.data.work_source?.labels?.ready).toBe("urgent");
254
+ }
255
+ });
256
+ it("rejects invalid schedule type", () => {
257
+ const result = ScheduleSchema.safeParse({
258
+ type: "invalid",
259
+ });
260
+ expect(result.success).toBe(false);
261
+ });
262
+ });
263
+ describe("McpServerSchema", () => {
264
+ it("parses command-based MCP server", () => {
265
+ const server = {
266
+ command: "npx",
267
+ args: ["-y", "@modelcontextprotocol/server-github"],
268
+ env: {
269
+ GITHUB_TOKEN: "token",
270
+ },
271
+ };
272
+ const result = McpServerSchema.safeParse(server);
273
+ expect(result.success).toBe(true);
274
+ if (result.success) {
275
+ expect(result.data.command).toBe("npx");
276
+ expect(result.data.args).toContain("-y");
277
+ }
278
+ });
279
+ it("parses URL-based MCP server", () => {
280
+ const server = {
281
+ url: "http://localhost:3000/mcp",
282
+ };
283
+ const result = McpServerSchema.safeParse(server);
284
+ expect(result.success).toBe(true);
285
+ if (result.success) {
286
+ expect(result.data.url).toBe("http://localhost:3000/mcp");
287
+ }
288
+ });
289
+ it("parses empty MCP server config", () => {
290
+ const result = McpServerSchema.safeParse({});
291
+ expect(result.success).toBe(true);
292
+ });
293
+ });
294
+ describe("AgentChatSchema", () => {
295
+ it("parses empty chat config", () => {
296
+ const result = AgentChatSchema.safeParse({});
297
+ expect(result.success).toBe(true);
298
+ });
299
+ it("parses discord chat config", () => {
300
+ const chat = {
301
+ discord: {
302
+ channel_ids: ["123", "456"],
303
+ respond_to_mentions: false,
304
+ },
305
+ };
306
+ const result = AgentChatSchema.safeParse(chat);
307
+ expect(result.success).toBe(true);
308
+ if (result.success) {
309
+ expect(result.data.discord?.channel_ids).toHaveLength(2);
310
+ expect(result.data.discord?.respond_to_mentions).toBe(false);
311
+ }
312
+ });
313
+ it("applies default respond_to_mentions", () => {
314
+ const chat = {
315
+ discord: {
316
+ channel_ids: ["123"],
317
+ },
318
+ };
319
+ const result = AgentChatSchema.safeParse(chat);
320
+ expect(result.success).toBe(true);
321
+ if (result.success) {
322
+ expect(result.data.discord?.respond_to_mentions).toBe(true);
323
+ }
324
+ });
325
+ });
326
+ describe("parseAgentConfig", () => {
327
+ it("parses valid agent YAML", () => {
328
+ const yaml = `
329
+ name: test-agent
330
+ description: A test agent
331
+ `;
332
+ const config = parseAgentConfig(yaml);
333
+ expect(config.name).toBe("test-agent");
334
+ expect(config.description).toBe("A test agent");
335
+ });
336
+ it("parses complete agent YAML from SPEC example", () => {
337
+ const yaml = `
338
+ name: bragdoc-coder
339
+ description: A coding assistant for the bragdoc project
340
+ workspace: ~/projects/bragdoc
341
+ repo: https://github.com/example/bragdoc
342
+
343
+ identity:
344
+ name: Cody
345
+ role: developer
346
+
347
+ work_source:
348
+ type: github
349
+ labels:
350
+ ready: "ready"
351
+ in_progress: "in-progress"
352
+
353
+ schedules:
354
+ main:
355
+ type: interval
356
+ interval: "5m"
357
+ prompt: Check for new issues
358
+
359
+ permissions:
360
+ mode: acceptEdits
361
+ allowed_tools:
362
+ - Read
363
+ - Edit
364
+ - Write
365
+ - Bash
366
+ bash:
367
+ allowed_commands:
368
+ - git
369
+ - npm
370
+ - pnpm
371
+
372
+ mcp_servers:
373
+ github:
374
+ command: npx
375
+ args:
376
+ - "-y"
377
+ - "@modelcontextprotocol/server-github"
378
+
379
+ model: claude-sonnet-4-20250514
380
+ max_turns: 100
381
+ `;
382
+ const config = parseAgentConfig(yaml, "/path/to/agent.yaml");
383
+ expect(config.name).toBe("bragdoc-coder");
384
+ expect(config.workspace).toBe("~/projects/bragdoc");
385
+ expect(config.repo).toBe("https://github.com/example/bragdoc");
386
+ expect(config.identity?.name).toBe("Cody");
387
+ expect(config.work_source?.type).toBe("github");
388
+ expect(config.schedules?.main.type).toBe("interval");
389
+ expect(config.permissions?.mode).toBe("acceptEdits");
390
+ expect(config.mcp_servers?.github.command).toBe("npx");
391
+ expect(config.model).toBe("claude-sonnet-4-20250514");
392
+ expect(config.max_turns).toBe(100);
393
+ });
394
+ it("throws AgentYamlSyntaxError for invalid YAML", () => {
395
+ const yaml = `
396
+ name: test-agent
397
+ bad: indentation
398
+ `;
399
+ expect(() => parseAgentConfig(yaml, "/path/to/agent.yaml")).toThrow(AgentYamlSyntaxError);
400
+ });
401
+ it("includes file path in AgentYamlSyntaxError", () => {
402
+ const yaml = `name: test
403
+ bad: indent`;
404
+ try {
405
+ parseAgentConfig(yaml, "/path/to/agent.yaml");
406
+ expect.fail("Should have thrown");
407
+ }
408
+ catch (error) {
409
+ expect(error).toBeInstanceOf(AgentYamlSyntaxError);
410
+ const yamlError = error;
411
+ expect(yamlError.filePath).toBe("/path/to/agent.yaml");
412
+ expect(yamlError.message).toContain("/path/to/agent.yaml");
413
+ }
414
+ });
415
+ it("throws AgentValidationError for missing required fields", () => {
416
+ const yaml = `
417
+ description: An agent without a name
418
+ `;
419
+ expect(() => parseAgentConfig(yaml, "/path/to/agent.yaml")).toThrow(AgentValidationError);
420
+ });
421
+ it("includes file path and field info in AgentValidationError", () => {
422
+ const yaml = `
423
+ description: Missing name field
424
+ `;
425
+ try {
426
+ parseAgentConfig(yaml, "/path/to/agent.yaml");
427
+ expect.fail("Should have thrown");
428
+ }
429
+ catch (error) {
430
+ expect(error).toBeInstanceOf(AgentValidationError);
431
+ const validationError = error;
432
+ expect(validationError.filePath).toBe("/path/to/agent.yaml");
433
+ expect(validationError.message).toContain("/path/to/agent.yaml");
434
+ expect(validationError.issues).toHaveLength(1);
435
+ expect(validationError.issues[0].path).toBe("name");
436
+ }
437
+ });
438
+ it("throws AgentValidationError for empty file", () => {
439
+ const yaml = "";
440
+ expect(() => parseAgentConfig(yaml, "/path/to/agent.yaml")).toThrow(AgentValidationError);
441
+ });
442
+ it("throws AgentValidationError for invalid permission mode", () => {
443
+ const yaml = `
444
+ name: test-agent
445
+ permission_mode: invalid
446
+ `;
447
+ expect(() => parseAgentConfig(yaml)).toThrow(AgentValidationError);
448
+ });
449
+ it("reports multiple validation errors", () => {
450
+ const yaml = `
451
+ max_turns: "not-a-number"
452
+ permission_mode: invalid
453
+ `;
454
+ try {
455
+ parseAgentConfig(yaml);
456
+ expect.fail("Should have thrown");
457
+ }
458
+ catch (error) {
459
+ expect(error).toBeInstanceOf(AgentValidationError);
460
+ const validationError = error;
461
+ expect(validationError.issues.length).toBeGreaterThanOrEqual(2);
462
+ }
463
+ });
464
+ it("uses default file path when not provided", () => {
465
+ const yaml = `description: missing name`;
466
+ try {
467
+ parseAgentConfig(yaml);
468
+ expect.fail("Should have thrown");
469
+ }
470
+ catch (error) {
471
+ expect(error).toBeInstanceOf(AgentValidationError);
472
+ const validationError = error;
473
+ expect(validationError.filePath).toBe("<unknown>");
474
+ }
475
+ });
476
+ });
477
+ describe("validateAgentConfig", () => {
478
+ it("validates a valid config object", () => {
479
+ const config = {
480
+ name: "test-agent",
481
+ description: "A test agent",
482
+ };
483
+ const validated = validateAgentConfig(config);
484
+ expect(validated.name).toBe("test-agent");
485
+ });
486
+ it("throws AgentValidationError for invalid object", () => {
487
+ const config = {
488
+ description: "Missing name",
489
+ };
490
+ expect(() => validateAgentConfig(config, "/path/to/agent.yaml")).toThrow(AgentValidationError);
491
+ });
492
+ it("includes file path in error", () => {
493
+ try {
494
+ validateAgentConfig({}, "/custom/path.yaml");
495
+ expect.fail("Should have thrown");
496
+ }
497
+ catch (error) {
498
+ expect(error).toBeInstanceOf(AgentValidationError);
499
+ const validationError = error;
500
+ expect(validationError.filePath).toBe("/custom/path.yaml");
501
+ }
502
+ });
503
+ });
504
+ describe("safeParseAgentConfig", () => {
505
+ it("returns success for valid YAML", () => {
506
+ const yaml = `
507
+ name: test-agent
508
+ description: Test
509
+ `;
510
+ const result = safeParseAgentConfig(yaml);
511
+ expect(result.success).toBe(true);
512
+ if (result.success) {
513
+ expect(result.data.name).toBe("test-agent");
514
+ }
515
+ });
516
+ it("returns error for invalid YAML syntax", () => {
517
+ const yaml = `
518
+ name: test
519
+ bad: indent
520
+ `;
521
+ const result = safeParseAgentConfig(yaml, "/path/to/agent.yaml");
522
+ expect(result.success).toBe(false);
523
+ if (!result.success) {
524
+ expect(result.error).toBeInstanceOf(AgentYamlSyntaxError);
525
+ }
526
+ });
527
+ it("returns error for schema validation failure", () => {
528
+ const yaml = `
529
+ description: missing name
530
+ `;
531
+ const result = safeParseAgentConfig(yaml, "/path/to/agent.yaml");
532
+ expect(result.success).toBe(false);
533
+ if (!result.success) {
534
+ expect(result.error).toBeInstanceOf(AgentValidationError);
535
+ }
536
+ });
537
+ });
538
+ describe("resolveAgentPath", () => {
539
+ it("returns absolute paths unchanged", () => {
540
+ const result = resolveAgentPath("/absolute/path/agent.yaml", "/base/dir");
541
+ expect(result).toBe("/absolute/path/agent.yaml");
542
+ });
543
+ it("resolves relative paths from base path", () => {
544
+ const result = resolveAgentPath("./agents/test.yaml", "/base/dir");
545
+ expect(result).toBe("/base/dir/agents/test.yaml");
546
+ });
547
+ it("resolves paths without ./ prefix", () => {
548
+ const result = resolveAgentPath("agents/test.yaml", "/base/dir");
549
+ expect(result).toBe("/base/dir/agents/test.yaml");
550
+ });
551
+ it("handles parent directory references", () => {
552
+ const result = resolveAgentPath("../other/agent.yaml", "/base/dir");
553
+ expect(result).toBe("/base/other/agent.yaml");
554
+ });
555
+ });
556
+ describe("loadAgentConfig", () => {
557
+ let testDir;
558
+ beforeEach(async () => {
559
+ testDir = join(tmpdir(), `herdctl-test-${Date.now()}`);
560
+ await mkdir(testDir, { recursive: true });
561
+ });
562
+ afterEach(async () => {
563
+ await rm(testDir, { recursive: true, force: true });
564
+ });
565
+ it("loads and parses an agent file", async () => {
566
+ const agentPath = join(testDir, "agent.yaml");
567
+ await writeFile(agentPath, `
568
+ name: test-agent
569
+ description: A test agent
570
+ model: claude-sonnet-4-20250514
571
+ `);
572
+ const config = await loadAgentConfig(agentPath);
573
+ expect(config.name).toBe("test-agent");
574
+ expect(config.model).toBe("claude-sonnet-4-20250514");
575
+ });
576
+ it("resolves relative path from fleet config", async () => {
577
+ const agentsDir = join(testDir, "agents");
578
+ await mkdir(agentsDir, { recursive: true });
579
+ const agentPath = join(agentsDir, "test.yaml");
580
+ await writeFile(agentPath, `
581
+ name: relative-agent
582
+ `);
583
+ const fleetConfigPath = join(testDir, "herdctl.yaml");
584
+ const config = await loadAgentConfig("./agents/test.yaml", fleetConfigPath);
585
+ expect(config.name).toBe("relative-agent");
586
+ });
587
+ it("throws FileReadError for non-existent file", async () => {
588
+ await expect(loadAgentConfig("/non/existent/agent.yaml")).rejects.toThrow(FileReadError);
589
+ });
590
+ it("includes file path in FileReadError", async () => {
591
+ const nonExistentPath = "/non/existent/agent.yaml";
592
+ try {
593
+ await loadAgentConfig(nonExistentPath);
594
+ expect.fail("Should have thrown");
595
+ }
596
+ catch (error) {
597
+ expect(error).toBeInstanceOf(FileReadError);
598
+ const fileError = error;
599
+ expect(fileError.filePath).toBe(nonExistentPath);
600
+ expect(fileError.message).toContain(nonExistentPath);
601
+ }
602
+ });
603
+ it("throws AgentYamlSyntaxError for invalid YAML file", async () => {
604
+ const agentPath = join(testDir, "invalid.yaml");
605
+ await writeFile(agentPath, `
606
+ name: test
607
+ bad: indent
608
+ `);
609
+ await expect(loadAgentConfig(agentPath)).rejects.toThrow(AgentYamlSyntaxError);
610
+ });
611
+ it("throws AgentValidationError for invalid config file", async () => {
612
+ const agentPath = join(testDir, "invalid-config.yaml");
613
+ await writeFile(agentPath, `
614
+ description: Missing name field
615
+ `);
616
+ await expect(loadAgentConfig(agentPath)).rejects.toThrow(AgentValidationError);
617
+ });
618
+ it("handles complex agent with all fields", async () => {
619
+ const agentPath = join(testDir, "complex.yaml");
620
+ await writeFile(agentPath, `
621
+ name: complex-agent
622
+ description: A fully configured agent
623
+ workspace: ~/workspace
624
+ repo: https://github.com/example/repo
625
+
626
+ identity:
627
+ name: Ava
628
+ role: assistant
629
+ personality: helpful
630
+
631
+ work_source:
632
+ type: github
633
+ labels:
634
+ ready: "ready"
635
+
636
+ schedules:
637
+ polling:
638
+ type: interval
639
+ interval: "10m"
640
+
641
+ session:
642
+ max_turns: 50
643
+ timeout: "1h"
644
+ model: claude-opus-4-20250514
645
+
646
+ permissions:
647
+ mode: bypassPermissions
648
+ allowed_tools:
649
+ - Read
650
+ - Write
651
+
652
+ mcp_servers:
653
+ test:
654
+ command: node
655
+ args:
656
+ - server.js
657
+
658
+ chat:
659
+ discord:
660
+ channel_ids:
661
+ - "123456"
662
+
663
+ model: claude-sonnet-4-20250514
664
+ max_turns: 100
665
+ permission_mode: acceptEdits
666
+ `);
667
+ const config = await loadAgentConfig(agentPath);
668
+ expect(config.name).toBe("complex-agent");
669
+ expect(config.identity?.name).toBe("Ava");
670
+ expect(config.schedules?.polling.type).toBe("interval");
671
+ expect(config.session?.max_turns).toBe(50);
672
+ expect(config.permissions?.mode).toBe("bypassPermissions");
673
+ expect(config.mcp_servers?.test.command).toBe("node");
674
+ expect(config.chat?.discord?.channel_ids).toContain("123456");
675
+ });
676
+ });
677
+ describe("Error classes", () => {
678
+ it("AgentValidationError has correct properties", () => {
679
+ const mockZodError = {
680
+ issues: [
681
+ { path: ["name"], message: "Required", code: "invalid_type" },
682
+ { path: ["max_turns"], message: "Expected number", code: "invalid_type" },
683
+ ],
684
+ };
685
+ const error = new AgentValidationError(mockZodError, "/path/to/agent.yaml");
686
+ expect(error.name).toBe("AgentValidationError");
687
+ expect(error.filePath).toBe("/path/to/agent.yaml");
688
+ expect(error.issues).toHaveLength(2);
689
+ expect(error.message).toContain("/path/to/agent.yaml");
690
+ expect(error.message).toContain("name: Required");
691
+ expect(error.message).toContain("max_turns: Expected number");
692
+ });
693
+ it("AgentYamlSyntaxError has correct properties", () => {
694
+ const mockYamlError = {
695
+ message: "Bad indentation",
696
+ linePos: [{ line: 5, col: 3 }],
697
+ };
698
+ const error = new AgentYamlSyntaxError(mockYamlError, "/path/to/agent.yaml");
699
+ expect(error.name).toBe("AgentYamlSyntaxError");
700
+ expect(error.filePath).toBe("/path/to/agent.yaml");
701
+ expect(error.line).toBe(5);
702
+ expect(error.column).toBe(3);
703
+ expect(error.message).toContain("/path/to/agent.yaml");
704
+ expect(error.message).toContain("line 5");
705
+ expect(error.message).toContain("column 3");
706
+ });
707
+ it("AgentYamlSyntaxError handles missing position", () => {
708
+ const mockYamlError = {
709
+ message: "Unknown error",
710
+ linePos: undefined,
711
+ };
712
+ const error = new AgentYamlSyntaxError(mockYamlError, "/path/to/agent.yaml");
713
+ expect(error.line).toBeUndefined();
714
+ expect(error.column).toBeUndefined();
715
+ expect(error.message).toContain("/path/to/agent.yaml");
716
+ });
717
+ it("FileReadError has correct properties", () => {
718
+ const cause = new Error("ENOENT: no such file");
719
+ const error = new FileReadError("/path/to/agent.yaml", cause);
720
+ expect(error.name).toBe("FileReadError");
721
+ expect(error.filePath).toBe("/path/to/agent.yaml");
722
+ expect(error.message).toContain("/path/to/agent.yaml");
723
+ expect(error.message).toContain("ENOENT");
724
+ });
725
+ it("FileReadError works without cause", () => {
726
+ const error = new FileReadError("/path/to/agent.yaml");
727
+ expect(error.name).toBe("FileReadError");
728
+ expect(error.message).toContain("/path/to/agent.yaml");
729
+ });
730
+ });
731
+ describe("type safety", () => {
732
+ it("returns properly typed AgentConfig", () => {
733
+ const yaml = `
734
+ name: test-agent
735
+ description: A test
736
+ model: claude-sonnet-4-20250514
737
+ max_turns: 50
738
+ permission_mode: acceptEdits
739
+ `;
740
+ const config = parseAgentConfig(yaml);
741
+ // TypeScript compilation verifies these types
742
+ const _name = config.name;
743
+ const _description = config.description;
744
+ const _model = config.model;
745
+ const _maxTurns = config.max_turns;
746
+ expect(_name).toBe("test-agent");
747
+ expect(_description).toBe("A test");
748
+ expect(_model).toBe("claude-sonnet-4-20250514");
749
+ expect(_maxTurns).toBe(50);
750
+ });
751
+ });
752
+ //# sourceMappingURL=agent.test.js.map