@nubl/maestro 0.0.1 → 0.1.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 (398) hide show
  1. package/README.md +55 -2
  2. package/dist/config.json.example +30 -0
  3. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
  4. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
  5. package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
  6. package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
  7. package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
  8. package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
  9. package/dist/maestro/adapters/pi/accept-groups.js +70 -0
  10. package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
  11. package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
  12. package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
  13. package/dist/maestro/adapters/pi/accept-runner.js +161 -0
  14. package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
  15. package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
  16. package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
  17. package/dist/maestro/adapters/pi/activity-file.js +454 -0
  18. package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
  19. package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
  20. package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
  21. package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
  22. package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
  23. package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
  24. package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
  25. package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
  26. package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
  27. package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
  28. package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
  29. package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
  30. package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
  31. package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
  32. package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
  33. package/dist/maestro/adapters/pi/child/entry.js +3 -0
  34. package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
  35. package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
  36. package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
  37. package/dist/maestro/adapters/pi/child/protocol.js +510 -0
  38. package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
  39. package/dist/maestro/adapters/pi/completion.d.ts +45 -0
  40. package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
  41. package/dist/maestro/adapters/pi/completion.js +295 -0
  42. package/dist/maestro/adapters/pi/completion.js.map +1 -0
  43. package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
  44. package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
  45. package/dist/maestro/adapters/pi/launch-command.js +75 -0
  46. package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
  47. package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
  48. package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
  49. package/dist/maestro/adapters/pi/launch-operations.js +270 -0
  50. package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
  51. package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
  52. package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
  53. package/dist/maestro/adapters/pi/launch-resume.js +183 -0
  54. package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
  55. package/dist/maestro/adapters/pi/launch.d.ts +148 -0
  56. package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
  57. package/dist/maestro/adapters/pi/launch.js +655 -0
  58. package/dist/maestro/adapters/pi/launch.js.map +1 -0
  59. package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
  60. package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
  61. package/dist/maestro/adapters/pi/model-registry.js +29 -0
  62. package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
  63. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
  64. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
  65. package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
  66. package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
  67. package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
  68. package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
  69. package/dist/maestro/adapters/pi/process-identity.js +248 -0
  70. package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
  71. package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
  72. package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
  73. package/dist/maestro/adapters/pi/process-tree.js +69 -0
  74. package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
  75. package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
  76. package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
  77. package/dist/maestro/adapters/pi/script-shell.js +43 -0
  78. package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
  79. package/dist/maestro/adapters/pi/session.d.ts +207 -0
  80. package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
  81. package/dist/maestro/adapters/pi/session.js +714 -0
  82. package/dist/maestro/adapters/pi/session.js.map +1 -0
  83. package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
  84. package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
  85. package/dist/maestro/adapters/pi/task-model-init.js +47 -0
  86. package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
  87. package/dist/maestro/core/accept.d.ts +150 -0
  88. package/dist/maestro/core/accept.d.ts.map +1 -0
  89. package/dist/maestro/core/accept.js +243 -0
  90. package/dist/maestro/core/accept.js.map +1 -0
  91. package/dist/maestro/core/activity.d.ts +4 -0
  92. package/dist/maestro/core/activity.d.ts.map +1 -0
  93. package/dist/maestro/core/activity.js +18 -0
  94. package/dist/maestro/core/activity.js.map +1 -0
  95. package/dist/maestro/core/child-busy.d.ts +14 -0
  96. package/dist/maestro/core/child-busy.d.ts.map +1 -0
  97. package/dist/maestro/core/child-busy.js +14 -0
  98. package/dist/maestro/core/child-busy.js.map +1 -0
  99. package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
  100. package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
  101. package/dist/maestro/core/config/guidelines-config.js +60 -0
  102. package/dist/maestro/core/config/guidelines-config.js.map +1 -0
  103. package/dist/maestro/core/config/herdr-config.d.ts +13 -0
  104. package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
  105. package/dist/maestro/core/config/herdr-config.js +65 -0
  106. package/dist/maestro/core/config/herdr-config.js.map +1 -0
  107. package/dist/maestro/core/config/model-config.d.ts +92 -0
  108. package/dist/maestro/core/config/model-config.d.ts.map +1 -0
  109. package/dist/maestro/core/config/model-config.js +522 -0
  110. package/dist/maestro/core/config/model-config.js.map +1 -0
  111. package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
  112. package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
  113. package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
  114. package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
  115. package/dist/maestro/core/config/pane-config.d.ts +15 -0
  116. package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
  117. package/dist/maestro/core/config/pane-config.js +101 -0
  118. package/dist/maestro/core/config/pane-config.js.map +1 -0
  119. package/dist/maestro/core/config/persistent-config.d.ts +7 -0
  120. package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
  121. package/dist/maestro/core/config/persistent-config.js +72 -0
  122. package/dist/maestro/core/config/persistent-config.js.map +1 -0
  123. package/dist/maestro/core/config/role-config.d.ts +7 -0
  124. package/dist/maestro/core/config/role-config.d.ts.map +1 -0
  125. package/dist/maestro/core/config/role-config.js +74 -0
  126. package/dist/maestro/core/config/role-config.js.map +1 -0
  127. package/dist/maestro/core/config/spawning-config.d.ts +7 -0
  128. package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
  129. package/dist/maestro/core/config/spawning-config.js +65 -0
  130. package/dist/maestro/core/config/spawning-config.js.map +1 -0
  131. package/dist/maestro/core/config/supervision-config.d.ts +7 -0
  132. package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
  133. package/dist/maestro/core/config/supervision-config.js +69 -0
  134. package/dist/maestro/core/config/supervision-config.js.map +1 -0
  135. package/dist/maestro/core/config/task-model-init.d.ts +118 -0
  136. package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
  137. package/dist/maestro/core/config/task-model-init.js +168 -0
  138. package/dist/maestro/core/config/task-model-init.js.map +1 -0
  139. package/dist/maestro/core/config/task-model-types.d.ts +36 -0
  140. package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
  141. package/dist/maestro/core/config/task-model-types.js +17 -0
  142. package/dist/maestro/core/config/task-model-types.js.map +1 -0
  143. package/dist/maestro/core/config/type-guards.d.ts +22 -0
  144. package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
  145. package/dist/maestro/core/config/type-guards.js +31 -0
  146. package/dist/maestro/core/config/type-guards.js.map +1 -0
  147. package/dist/maestro/core/deadline.d.ts +11 -0
  148. package/dist/maestro/core/deadline.d.ts.map +1 -0
  149. package/dist/maestro/core/deadline.js +30 -0
  150. package/dist/maestro/core/deadline.js.map +1 -0
  151. package/dist/maestro/core/declared-skills.d.ts +16 -0
  152. package/dist/maestro/core/declared-skills.d.ts.map +1 -0
  153. package/dist/maestro/core/declared-skills.js +52 -0
  154. package/dist/maestro/core/declared-skills.js.map +1 -0
  155. package/dist/maestro/core/delegation-depth.d.ts +38 -0
  156. package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
  157. package/dist/maestro/core/delegation-depth.js +59 -0
  158. package/dist/maestro/core/delegation-depth.js.map +1 -0
  159. package/dist/maestro/core/git-environment.d.ts +3 -0
  160. package/dist/maestro/core/git-environment.d.ts.map +1 -0
  161. package/dist/maestro/core/git-environment.js +29 -0
  162. package/dist/maestro/core/git-environment.js.map +1 -0
  163. package/dist/maestro/core/harness-adapter.d.ts +89 -0
  164. package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
  165. package/dist/maestro/core/harness-adapter.js +2 -0
  166. package/dist/maestro/core/harness-adapter.js.map +1 -0
  167. package/dist/maestro/core/host-text.d.ts +49 -0
  168. package/dist/maestro/core/host-text.d.ts.map +1 -0
  169. package/dist/maestro/core/host-text.js +106 -0
  170. package/dist/maestro/core/host-text.js.map +1 -0
  171. package/dist/maestro/core/index.d.ts +4 -0
  172. package/dist/maestro/core/index.d.ts.map +1 -0
  173. package/dist/maestro/core/index.js +2 -0
  174. package/dist/maestro/core/index.js.map +1 -0
  175. package/dist/maestro/core/lifecycle.d.ts +16 -0
  176. package/dist/maestro/core/lifecycle.d.ts.map +1 -0
  177. package/dist/maestro/core/lifecycle.js +429 -0
  178. package/dist/maestro/core/lifecycle.js.map +1 -0
  179. package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
  180. package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
  181. package/dist/maestro/core/opened-primary-workspace.js +49 -0
  182. package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
  183. package/dist/maestro/core/platform-support.d.ts +15 -0
  184. package/dist/maestro/core/platform-support.d.ts.map +1 -0
  185. package/dist/maestro/core/platform-support.js +23 -0
  186. package/dist/maestro/core/platform-support.js.map +1 -0
  187. package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
  188. package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
  189. package/dist/maestro/core/realpath-without-opening.js +45 -0
  190. package/dist/maestro/core/realpath-without-opening.js.map +1 -0
  191. package/dist/maestro/core/roles/discovery.d.ts +64 -0
  192. package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
  193. package/dist/maestro/core/roles/discovery.js +422 -0
  194. package/dist/maestro/core/roles/discovery.js.map +1 -0
  195. package/dist/maestro/core/routing.d.ts +115 -0
  196. package/dist/maestro/core/routing.d.ts.map +1 -0
  197. package/dist/maestro/core/routing.js +449 -0
  198. package/dist/maestro/core/routing.js.map +1 -0
  199. package/dist/maestro/core/script-launch.d.ts +47 -0
  200. package/dist/maestro/core/script-launch.d.ts.map +1 -0
  201. package/dist/maestro/core/script-launch.js +102 -0
  202. package/dist/maestro/core/script-launch.js.map +1 -0
  203. package/dist/maestro/core/shell.d.ts +2 -0
  204. package/dist/maestro/core/shell.d.ts.map +1 -0
  205. package/dist/maestro/core/shell.js +4 -0
  206. package/dist/maestro/core/shell.js.map +1 -0
  207. package/dist/maestro/core/specialist-notice.d.ts +36 -0
  208. package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
  209. package/dist/maestro/core/specialist-notice.js +41 -0
  210. package/dist/maestro/core/specialist-notice.js.map +1 -0
  211. package/dist/maestro/core/status.d.ts +87 -0
  212. package/dist/maestro/core/status.d.ts.map +1 -0
  213. package/dist/maestro/core/status.js +369 -0
  214. package/dist/maestro/core/status.js.map +1 -0
  215. package/dist/maestro/core/supervision.d.ts +56 -0
  216. package/dist/maestro/core/supervision.d.ts.map +1 -0
  217. package/dist/maestro/core/supervision.js +249 -0
  218. package/dist/maestro/core/supervision.js.map +1 -0
  219. package/dist/maestro/core/surface-provider.d.ts +200 -0
  220. package/dist/maestro/core/surface-provider.d.ts.map +1 -0
  221. package/dist/maestro/core/surface-provider.js +71 -0
  222. package/dist/maestro/core/surface-provider.js.map +1 -0
  223. package/dist/maestro/core/types.d.ts +388 -0
  224. package/dist/maestro/core/types.d.ts.map +1 -0
  225. package/dist/maestro/core/types.js +2 -0
  226. package/dist/maestro/core/types.js.map +1 -0
  227. package/dist/maestro/core/undelivered-children.d.ts +27 -0
  228. package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
  229. package/dist/maestro/core/undelivered-children.js +31 -0
  230. package/dist/maestro/core/undelivered-children.js.map +1 -0
  231. package/dist/maestro/core/wake.d.ts +32 -0
  232. package/dist/maestro/core/wake.d.ts.map +1 -0
  233. package/dist/maestro/core/wake.js +125 -0
  234. package/dist/maestro/core/wake.js.map +1 -0
  235. package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
  236. package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
  237. package/dist/maestro/core/worktree-cleanup.js +278 -0
  238. package/dist/maestro/core/worktree-cleanup.js.map +1 -0
  239. package/dist/maestro/core/worktree.d.ts +50 -0
  240. package/dist/maestro/core/worktree.d.ts.map +1 -0
  241. package/dist/maestro/core/worktree.js +23 -0
  242. package/dist/maestro/core/worktree.js.map +1 -0
  243. package/dist/maestro/engine.d.ts +5 -0
  244. package/dist/maestro/engine.d.ts.map +1 -0
  245. package/dist/maestro/engine.js +5 -0
  246. package/dist/maestro/engine.js.map +1 -0
  247. package/dist/maestro/pi/child.d.ts +8 -0
  248. package/dist/maestro/pi/child.d.ts.map +1 -0
  249. package/dist/maestro/pi/child.js +8 -0
  250. package/dist/maestro/pi/child.js.map +1 -0
  251. package/dist/maestro/pi/extension.d.ts +10 -0
  252. package/dist/maestro/pi/extension.d.ts.map +1 -0
  253. package/dist/maestro/pi/extension.js +8 -0
  254. package/dist/maestro/pi/extension.js.map +1 -0
  255. package/dist/maestro/pi/subagents-index.d.ts +9 -0
  256. package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
  257. package/dist/maestro/pi/subagents-index.js +9 -0
  258. package/dist/maestro/pi/subagents-index.js.map +1 -0
  259. package/dist/maestro/pi.d.ts +9 -0
  260. package/dist/maestro/pi.d.ts.map +1 -0
  261. package/dist/maestro/pi.js +7 -0
  262. package/dist/maestro/pi.js.map +1 -0
  263. package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
  264. package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
  265. package/dist/maestro/runtime/accept-recheck.js +92 -0
  266. package/dist/maestro/runtime/accept-recheck.js.map +1 -0
  267. package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
  268. package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
  269. package/dist/maestro/runtime/delegated-marker.js +200 -0
  270. package/dist/maestro/runtime/delegated-marker.js.map +1 -0
  271. package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
  272. package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
  273. package/dist/maestro/runtime/host-surface-binding.js +2 -0
  274. package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
  275. package/dist/maestro/runtime/index.d.ts +10 -0
  276. package/dist/maestro/runtime/index.d.ts.map +1 -0
  277. package/dist/maestro/runtime/index.js +6 -0
  278. package/dist/maestro/runtime/index.js.map +1 -0
  279. package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
  280. package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
  281. package/dist/maestro/runtime/pi-persistent-io.js +64 -0
  282. package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
  283. package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
  284. package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
  285. package/dist/maestro/runtime/pi-run-session-types.js +2 -0
  286. package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
  287. package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
  288. package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
  289. package/dist/maestro/runtime/pi-run-session.js +809 -0
  290. package/dist/maestro/runtime/pi-run-session.js.map +1 -0
  291. package/dist/maestro/runtime/run-session.d.ts +129 -0
  292. package/dist/maestro/runtime/run-session.d.ts.map +1 -0
  293. package/dist/maestro/runtime/run-session.js +680 -0
  294. package/dist/maestro/runtime/run-session.js.map +1 -0
  295. package/dist/maestro/runtime/surface-retention.d.ts +3 -0
  296. package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
  297. package/dist/maestro/runtime/surface-retention.js +5 -0
  298. package/dist/maestro/runtime/surface-retention.js.map +1 -0
  299. package/dist/maestro/runtime/task-model-init.d.ts +34 -0
  300. package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
  301. package/dist/maestro/runtime/task-model-init.js +78 -0
  302. package/dist/maestro/runtime/task-model-init.js.map +1 -0
  303. package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
  304. package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
  305. package/dist/maestro/runtime/worktree-operations.js +633 -0
  306. package/dist/maestro/runtime/worktree-operations.js.map +1 -0
  307. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
  308. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
  309. package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
  310. package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
  311. package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
  312. package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
  313. package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
  314. package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
  315. package/dist/maestro/testing/index.d.ts +5 -0
  316. package/dist/maestro/testing/index.d.ts.map +1 -0
  317. package/dist/maestro/testing/index.js +5 -0
  318. package/dist/maestro/testing/index.js.map +1 -0
  319. package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
  320. package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
  321. package/dist/maestro/testing/surface-provider.conformance.js +167 -0
  322. package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
  323. package/dist/pi-extension/subagents/catalog.d.ts +70 -0
  324. package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
  325. package/dist/pi-extension/subagents/catalog.js +231 -0
  326. package/dist/pi-extension/subagents/catalog.js.map +1 -0
  327. package/dist/pi-extension/subagents/config-path.d.ts +6 -0
  328. package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
  329. package/dist/pi-extension/subagents/config-path.js +21 -0
  330. package/dist/pi-extension/subagents/config-path.js.map +1 -0
  331. package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
  332. package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
  333. package/dist/pi-extension/subagents/control-tools.js +150 -0
  334. package/dist/pi-extension/subagents/control-tools.js.map +1 -0
  335. package/dist/pi-extension/subagents/controls.d.ts +52 -0
  336. package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
  337. package/dist/pi-extension/subagents/controls.js +173 -0
  338. package/dist/pi-extension/subagents/controls.js.map +1 -0
  339. package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
  340. package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
  341. package/dist/pi-extension/subagents/deferred-tools.js +67 -0
  342. package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
  343. package/dist/pi-extension/subagents/delivery.d.ts +22 -0
  344. package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
  345. package/dist/pi-extension/subagents/delivery.js +365 -0
  346. package/dist/pi-extension/subagents/delivery.js.map +1 -0
  347. package/dist/pi-extension/subagents/extension.d.ts +100 -0
  348. package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
  349. package/dist/pi-extension/subagents/extension.js +367 -0
  350. package/dist/pi-extension/subagents/extension.js.map +1 -0
  351. package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
  352. package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
  353. package/dist/pi-extension/subagents/launch-tools.js +373 -0
  354. package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
  355. package/dist/pi-extension/subagents/launch.d.ts +86 -0
  356. package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
  357. package/dist/pi-extension/subagents/launch.js +133 -0
  358. package/dist/pi-extension/subagents/launch.js.map +1 -0
  359. package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
  360. package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
  361. package/dist/pi-extension/subagents/model-registry.js +52 -0
  362. package/dist/pi-extension/subagents/model-registry.js.map +1 -0
  363. package/dist/pi-extension/subagents/observation.d.ts +38 -0
  364. package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
  365. package/dist/pi-extension/subagents/observation.js +168 -0
  366. package/dist/pi-extension/subagents/observation.js.map +1 -0
  367. package/dist/pi-extension/subagents/persistent.d.ts +72 -0
  368. package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
  369. package/dist/pi-extension/subagents/persistent.js +322 -0
  370. package/dist/pi-extension/subagents/persistent.js.map +1 -0
  371. package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
  372. package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
  373. package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
  374. package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
  375. package/dist/pi-extension/subagents/presentation.d.ts +149 -0
  376. package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
  377. package/dist/pi-extension/subagents/presentation.js +419 -0
  378. package/dist/pi-extension/subagents/presentation.js.map +1 -0
  379. package/dist/pi-extension/subagents/state.d.ts +183 -0
  380. package/dist/pi-extension/subagents/state.d.ts.map +1 -0
  381. package/dist/pi-extension/subagents/state.js +92 -0
  382. package/dist/pi-extension/subagents/state.js.map +1 -0
  383. package/dist/pi-extension/subagents/task-models.d.ts +9 -0
  384. package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
  385. package/dist/pi-extension/subagents/task-models.js +293 -0
  386. package/dist/pi-extension/subagents/task-models.js.map +1 -0
  387. package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
  388. package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
  389. package/dist/pi-extension/subagents/tool-boundary.js +53 -0
  390. package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
  391. package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
  392. package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
  393. package/dist/pi-extension/subagents/worktree-tools.js +185 -0
  394. package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
  395. package/dist/provenance.json +5 -0
  396. package/package.json +540 -27
  397. package/index.d.ts +0 -1
  398. package/index.js +0 -2
@@ -0,0 +1,45 @@
1
+ import { lstatSync, readlinkSync, statSync } from "node:fs";
2
+ import { join, parse, resolve, sep } from "node:path";
3
+ /**
4
+ * Resolve symbolic links with lstat, stat, and readlink only, matching Node's
5
+ * JavaScript realpathSync, including its lexical `..` handling. Bun's
6
+ * realpathSync opens the path, and open() blocks indefinitely on some
7
+ * protected macOS directories, such as another app's sandbox container,
8
+ * freezing the whole process.
9
+ */
10
+ export function realpathWithoutOpening(path) {
11
+ // A root is `/` on POSIX but `C:\` or `\\host\share\` on Windows, and a link
12
+ // target may name another one, so each absolute path carries its own root.
13
+ const split = (from) => {
14
+ const absolute = resolve(from);
15
+ const { root } = parse(absolute);
16
+ return {
17
+ root,
18
+ parts: absolute.slice(root.length).split(sep).filter(Boolean),
19
+ };
20
+ };
21
+ const start = split(path);
22
+ let pending = start.parts;
23
+ let resolved = start.root;
24
+ let links = 0;
25
+ while (pending.length) {
26
+ const next = join(resolved, pending.shift() ?? "");
27
+ if (!lstatSync(next).isSymbolicLink()) {
28
+ resolved = next;
29
+ continue;
30
+ }
31
+ // Like Node, let the kernel validate the target: missing targets throw
32
+ // ENOENT and real cycles throw ELOOP.
33
+ statSync(next);
34
+ // Backstop only; valid repeated traversals stay far below this.
35
+ if (++links > 4096)
36
+ throw Object.assign(new Error(`Too many symbolic links: ${path}`), {
37
+ code: "ELOOP",
38
+ });
39
+ const target = split(resolve(resolved, readlinkSync(next)));
40
+ pending = [...target.parts, ...pending];
41
+ resolved = target.root;
42
+ }
43
+ return resolved;
44
+ }
45
+ //# sourceMappingURL=realpath-without-opening.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"realpath-without-opening.js","sourceRoot":"","sources":["../../../maestro/core/realpath-without-opening.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO;YACN,IAAI;YACJ,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;SAC7D,CAAC;IACH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,QAAQ,GAAW,KAAK,CAAC,IAAI,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;YACvC,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACV,CAAC;QACD,uEAAuE;QACvE,sCAAsC;QACtC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,gEAAgE;QAChE,IAAI,EAAE,KAAK,GAAG,IAAI;YACjB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,EAAE;gBAClE,IAAI,EAAE,OAAO;aACb,CAAC,CAAC;QACJ,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC;QACxC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC","sourcesContent":["import { lstatSync, readlinkSync, statSync } from \"node:fs\";\nimport { join, parse, resolve, sep } from \"node:path\";\n\n/**\n * Resolve symbolic links with lstat, stat, and readlink only, matching Node's\n * JavaScript realpathSync, including its lexical `..` handling. Bun's\n * realpathSync opens the path, and open() blocks indefinitely on some\n * protected macOS directories, such as another app's sandbox container,\n * freezing the whole process.\n */\nexport function realpathWithoutOpening(path: string): string {\n\t// A root is `/` on POSIX but `C:\\` or `\\\\host\\share\\` on Windows, and a link\n\t// target may name another one, so each absolute path carries its own root.\n\tconst split = (from: string) => {\n\t\tconst absolute = resolve(from);\n\t\tconst { root } = parse(absolute);\n\t\treturn {\n\t\t\troot,\n\t\t\tparts: absolute.slice(root.length).split(sep).filter(Boolean),\n\t\t};\n\t};\n\tconst start = split(path);\n\tlet pending = start.parts;\n\tlet resolved: string = start.root;\n\tlet links = 0;\n\twhile (pending.length) {\n\t\tconst next = join(resolved, pending.shift() ?? \"\");\n\t\tif (!lstatSync(next).isSymbolicLink()) {\n\t\t\tresolved = next;\n\t\t\tcontinue;\n\t\t}\n\t\t// Like Node, let the kernel validate the target: missing targets throw\n\t\t// ENOENT and real cycles throw ELOOP.\n\t\tstatSync(next);\n\t\t// Backstop only; valid repeated traversals stay far below this.\n\t\tif (++links > 4096)\n\t\t\tthrow Object.assign(new Error(`Too many symbolic links: ${path}`), {\n\t\t\t\tcode: \"ELOOP\",\n\t\t\t});\n\t\tconst target = split(resolve(resolved, readlinkSync(next)));\n\t\tpending = [...target.parts, ...pending];\n\t\tresolved = target.root;\n\t}\n\treturn resolved;\n}\n"]}
@@ -0,0 +1,64 @@
1
+ import { type ThinkingLevel } from "../routing.ts";
2
+ import type { Role } from "../types.ts";
3
+ export type SubagentSessionMode = "standalone" | "lineage-only" | "fork";
4
+ export interface AgentDefaults {
5
+ model?: string;
6
+ tools?: string;
7
+ skills?: string;
8
+ thinking?: ThinkingLevel;
9
+ denyTools?: string;
10
+ spawning?: boolean;
11
+ selfSpawn?: boolean;
12
+ persistent?: boolean;
13
+ autoExit?: boolean;
14
+ interactive?: boolean;
15
+ systemPromptMode?: "append" | "replace";
16
+ sessionMode?: SubagentSessionMode;
17
+ cwd?: string;
18
+ body?: string;
19
+ disableModelInvocation?: boolean;
20
+ }
21
+ type AgentSource = "package" | "global" | "project";
22
+ interface AgentDefinition extends AgentDefaults {
23
+ name: string;
24
+ description?: string;
25
+ disableModelInvocation: boolean;
26
+ }
27
+ export interface ListedAgentDefinition extends AgentDefinition {
28
+ /** Runtime role plus the unchanged raw listing/validation metadata above. */
29
+ role: Role;
30
+ source: AgentSource;
31
+ path: string;
32
+ provider?: string;
33
+ providerVersion?: string;
34
+ }
35
+ export interface AgentDiagnostic {
36
+ code: string;
37
+ message: string;
38
+ path?: string;
39
+ agentName?: string;
40
+ provider?: string;
41
+ }
42
+ export interface AgentCatalog {
43
+ agents: ListedAgentDefinition[];
44
+ diagnostics: AgentDiagnostic[];
45
+ }
46
+ export declare const ROLE_PACK_DISCOVERY_EVENT = "pi-herdr-subagents:roles:discover:v1";
47
+ export interface RolePackDiscoveryEvent {
48
+ apiVersion: 1;
49
+ register(path: string): void;
50
+ }
51
+ export interface RoleDiscoveryOptions {
52
+ agentConfigDir: string;
53
+ cwd: string;
54
+ onRolePackDiscovered?(event: RolePackDiscoveryEvent): void;
55
+ }
56
+ interface RolePackDiscoveryResult {
57
+ paths: string[];
58
+ diagnostics: AgentDiagnostic[];
59
+ }
60
+ export declare function discoverRolePackPaths(onRolePackDiscovered?: RoleDiscoveryOptions["onRolePackDiscovered"]): RolePackDiscoveryResult;
61
+ export declare function discoverAgentCatalog(options: RoleDiscoveryOptions): AgentCatalog;
62
+ export declare function discoverAgentDefinitions(options: RoleDiscoveryOptions): ListedAgentDefinition[];
63
+ export {};
64
+ //# sourceMappingURL=discovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../maestro/core/roles/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,KAAK,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpD,UAAU,eAAgB,SAAQ,aAAa;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC7D,6EAA6E;IAC7E,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,WAAW,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,yBAAyB,yCAAyC,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,CAAC,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC3D;AA+RD,UAAU,uBAAuB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CACpC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,GACjE,uBAAuB,CA4BzB;AAED,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,oBAAoB,GAC3B,YAAY,CAoMd;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,oBAAoB,GAC3B,qBAAqB,EAAE,CAEzB"}
@@ -0,0 +1,422 @@
1
+ import { basename, dirname, isAbsolute, join, resolve } from "node:path";
2
+ import { readdirSync, readFileSync, existsSync, statSync } from "node:fs";
3
+ import { isString } from "../config/type-guards.js";
4
+ import { isThinkingLevel } from "../routing.js";
5
+ export const ROLE_PACK_DISCOVERY_EVENT = "pi-herdr-subagents:roles:discover:v1";
6
+ function runtimeRole(definition, source, providerVersion) {
7
+ return {
8
+ name: definition.name,
9
+ version: providerVersion ?? "1",
10
+ description: definition.description ?? "",
11
+ systemPrompt: definition.body ?? "",
12
+ allowedTools: definition.tools
13
+ ?.split(",")
14
+ .map((tool) => tool.trim())
15
+ .filter(Boolean) ?? [],
16
+ defaults: {
17
+ model: definition.model,
18
+ thinking: definition.thinking,
19
+ sessionMode: definition.sessionMode,
20
+ spawning: definition.spawning,
21
+ selfSpawn: definition.selfSpawn,
22
+ autoExit: definition.autoExit,
23
+ interactive: definition.interactive,
24
+ persistent: definition.persistent,
25
+ systemPromptMode: definition.systemPromptMode,
26
+ denyTools: definition.denyTools
27
+ ?.split(",")
28
+ .map((tool) => tool.trim())
29
+ .filter(Boolean),
30
+ skills: definition.skills
31
+ ?.split(",")
32
+ .map((skill) => skill.trim())
33
+ .filter(Boolean),
34
+ cwd: definition.cwd,
35
+ },
36
+ source,
37
+ };
38
+ }
39
+ function getFrontmatterLines(frontmatter, key) {
40
+ const prefix = `${key}:`;
41
+ return frontmatter
42
+ .split("\n")
43
+ .filter((candidate) => candidate.startsWith(prefix));
44
+ }
45
+ function getFrontmatterValue(frontmatter, key) {
46
+ const line = getFrontmatterLines(frontmatter, key)[0];
47
+ return line?.slice(`${key}:`.length).trim() || undefined;
48
+ }
49
+ function isCapabilityDeclaration(line, field) {
50
+ const trimmed = line.trimStart();
51
+ const colon = trimmed.indexOf(":");
52
+ if (colon === -1)
53
+ return false;
54
+ const key = trimmed.slice(0, colon).trim();
55
+ return key === field || key === `"${field}"` || key === `'${field}'`;
56
+ }
57
+ function getCapabilityDeclarations(frontmatter, field) {
58
+ const canonicalPrefix = `${field}:`;
59
+ const lines = frontmatter.split("\n");
60
+ return {
61
+ canonical: lines.filter((line) => line.startsWith(canonicalPrefix)),
62
+ hasNoncanonical: lines.some((line) => isCapabilityDeclaration(line, field) &&
63
+ !line.startsWith(canonicalPrefix)),
64
+ };
65
+ }
66
+ function validateCapabilityDeclarations(frontmatter) {
67
+ for (const field of [
68
+ "tools",
69
+ "deny-tools",
70
+ "spawning",
71
+ "self-spawn",
72
+ "persistent",
73
+ ]) {
74
+ const declarations = getCapabilityDeclarations(frontmatter, field);
75
+ if (declarations.hasNoncanonical) {
76
+ return `${field} must use an unquoted, unindented key written exactly as ${field}:`;
77
+ }
78
+ if (declarations.canonical.length > 1) {
79
+ return `${field} may be declared only once.`;
80
+ }
81
+ if (declarations.canonical.length === 0)
82
+ continue;
83
+ const value = declarations.canonical[0].slice(`${field}:`.length).trim();
84
+ if (field === "spawning" ||
85
+ field === "self-spawn" ||
86
+ field === "persistent") {
87
+ if (value !== "true" && value !== "false") {
88
+ return `${field} must be true or false.`;
89
+ }
90
+ continue;
91
+ }
92
+ if (!value ||
93
+ value.startsWith("[") ||
94
+ value.startsWith("{") ||
95
+ value.startsWith("|") ||
96
+ value.startsWith(">") ||
97
+ value.includes("#") ||
98
+ value.includes('"') ||
99
+ value.includes("'") ||
100
+ value.split(",").some((entry) => !entry.trim())) {
101
+ return `${field} must use a non-empty comma-separated scalar; YAML lists and containers, comments and quotes are unsupported.`;
102
+ }
103
+ }
104
+ return undefined;
105
+ }
106
+ function parseOptionalBoolean(value) {
107
+ return value == null ? undefined : value === "true";
108
+ }
109
+ function parseSessionMode(value) {
110
+ if (value === "standalone" || value === "lineage-only" || value === "fork") {
111
+ return value;
112
+ }
113
+ return undefined;
114
+ }
115
+ function normalizeRoleText(content) {
116
+ return content.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n");
117
+ }
118
+ function parseAgentDefinition(content, fallbackName) {
119
+ const match = content.match(/^---\n([\s\S]*?)\n---/);
120
+ if (!match)
121
+ return null;
122
+ const frontmatter = match[1];
123
+ const body = content.replace(/^---\n[\s\S]*?\n---\n*/, "").trim();
124
+ const systemPromptMode = getFrontmatterValue(frontmatter, "system-prompt");
125
+ const thinking = getFrontmatterValue(frontmatter, "thinking");
126
+ return {
127
+ name: getFrontmatterValue(frontmatter, "name") ?? fallbackName,
128
+ description: getFrontmatterValue(frontmatter, "description"),
129
+ model: getFrontmatterValue(frontmatter, "model"),
130
+ tools: getFrontmatterValue(frontmatter, "tools"),
131
+ systemPromptMode: systemPromptMode === "replace"
132
+ ? "replace"
133
+ : systemPromptMode === "append"
134
+ ? "append"
135
+ : undefined,
136
+ skills: getFrontmatterValue(frontmatter, "skills") ??
137
+ getFrontmatterValue(frontmatter, "skill"),
138
+ thinking: thinking && isThinkingLevel(thinking) ? thinking : undefined,
139
+ denyTools: getFrontmatterValue(frontmatter, "deny-tools"),
140
+ spawning: parseOptionalBoolean(getFrontmatterValue(frontmatter, "spawning")),
141
+ selfSpawn: parseOptionalBoolean(getFrontmatterValue(frontmatter, "self-spawn")),
142
+ persistent: parseOptionalBoolean(getFrontmatterValue(frontmatter, "persistent")),
143
+ autoExit: parseOptionalBoolean(getFrontmatterValue(frontmatter, "auto-exit")),
144
+ interactive: parseOptionalBoolean(getFrontmatterValue(frontmatter, "interactive")),
145
+ sessionMode: parseSessionMode(getFrontmatterValue(frontmatter, "session-mode")),
146
+ cwd: getFrontmatterValue(frontmatter, "cwd"),
147
+ body: body || undefined,
148
+ disableModelInvocation: getFrontmatterValue(frontmatter, "disable-model-invocation")?.toLowerCase() === "true",
149
+ };
150
+ }
151
+ function invalidCapabilityDeclarationDiagnostic(content, agentName, path) {
152
+ const match = content.match(/^---\n([\s\S]*?)\n---/);
153
+ if (!match)
154
+ return null;
155
+ const resolvedAgentName = getFrontmatterValue(match[1], "name") ?? agentName;
156
+ const error = validateCapabilityDeclarations(match[1]);
157
+ if (!error)
158
+ return null;
159
+ return {
160
+ code: "invalid-capability-declaration",
161
+ message: `Role "${resolvedAgentName}" has an invalid capability declaration in ${path}: ${error} Use documented comma-separated tools or deny-tools values, true or false for spawning or self-spawn, or omit the field.`,
162
+ path,
163
+ agentName: resolvedAgentName,
164
+ };
165
+ }
166
+ function legacyExternalCliDiagnostic(content, agentName, path) {
167
+ const match = content.match(/^---\n([\s\S]*?)\n---/);
168
+ const cli = match ? getFrontmatterValue(match[1], "cli") : undefined;
169
+ if (!match || !cli)
170
+ return null;
171
+ const resolvedAgentName = getFrontmatterValue(match[1], "name") ?? agentName;
172
+ return {
173
+ code: "external-cli-unsupported",
174
+ message: `Role "${resolvedAgentName}" requests external CLI "${cli}" in ${path}. pi-herdr-agents is Pi-only; remove the cli and cli-model fields and select Claude through an authenticated Pi provider/model ID.`,
175
+ path,
176
+ agentName: resolvedAgentName,
177
+ };
178
+ }
179
+ function listMarkdownFiles(path) {
180
+ const stat = statSync(path);
181
+ if (stat.isFile())
182
+ return path.endsWith(".md") ? [path] : [];
183
+ if (!stat.isDirectory())
184
+ return [];
185
+ return readdirSync(path)
186
+ .filter((entry) => entry.endsWith(".md"))
187
+ .sort((left, right) => left.localeCompare(right))
188
+ .map((entry) => join(path, entry));
189
+ }
190
+ function findPackageMetadata(path) {
191
+ let current = statSync(path).isDirectory() ? path : dirname(path);
192
+ while (true) {
193
+ const packagePath = join(current, "package.json");
194
+ if (existsSync(packagePath)) {
195
+ try {
196
+ const pkg = JSON.parse(readFileSync(packagePath, "utf8"));
197
+ return {
198
+ provider: isString(pkg.name) ? pkg.name : undefined,
199
+ providerVersion: isString(pkg.version) ? pkg.version : undefined,
200
+ };
201
+ }
202
+ catch {
203
+ return {};
204
+ }
205
+ }
206
+ const parent = dirname(current);
207
+ if (parent === current)
208
+ return {};
209
+ current = parent;
210
+ }
211
+ }
212
+ export function discoverRolePackPaths(onRolePackDiscovered) {
213
+ const paths = new Set();
214
+ const diagnostics = [];
215
+ if (!onRolePackDiscovered)
216
+ return { paths: [], diagnostics };
217
+ try {
218
+ onRolePackDiscovered({
219
+ apiVersion: 1,
220
+ register(path) {
221
+ if (!isString(path) || !isAbsolute(path)) {
222
+ diagnostics.push({
223
+ code: "invalid-role-pack-path",
224
+ message: "Role packs must register an absolute file or directory path.",
225
+ });
226
+ return;
227
+ }
228
+ paths.add(resolve(path));
229
+ },
230
+ });
231
+ }
232
+ catch (error) {
233
+ diagnostics.push({
234
+ code: "role-pack-discovery-failed",
235
+ message: `Role-pack discovery failed: ${error instanceof Error ? error.message : String(error)}`,
236
+ });
237
+ }
238
+ return { paths: [...paths], diagnostics };
239
+ }
240
+ export function discoverAgentCatalog(options) {
241
+ const agents = new Map();
242
+ const diagnostics = [];
243
+ const addDirectory = (path, source) => {
244
+ if (!existsSync(path))
245
+ return;
246
+ for (const filePath of listMarkdownFiles(path)) {
247
+ const fallbackName = basename(filePath, ".md");
248
+ let content;
249
+ try {
250
+ content = normalizeRoleText(readFileSync(filePath, "utf8"));
251
+ }
252
+ catch (error) {
253
+ agents.delete(fallbackName);
254
+ diagnostics.push({
255
+ code: "unreadable-role-definition",
256
+ message: `Cannot read role definition ${filePath}: ${error instanceof Error ? error.message : String(error)}`,
257
+ path: filePath,
258
+ agentName: fallbackName,
259
+ });
260
+ continue;
261
+ }
262
+ const legacyDiagnostic = legacyExternalCliDiagnostic(content, fallbackName, filePath);
263
+ if (legacyDiagnostic) {
264
+ diagnostics.push(legacyDiagnostic);
265
+ agents.delete(legacyDiagnostic.agentName ?? fallbackName);
266
+ continue;
267
+ }
268
+ const capabilityDiagnostic = invalidCapabilityDeclarationDiagnostic(content, fallbackName, filePath);
269
+ if (capabilityDiagnostic) {
270
+ diagnostics.push(capabilityDiagnostic);
271
+ agents.delete(capabilityDiagnostic.agentName ?? fallbackName);
272
+ continue;
273
+ }
274
+ const parsed = parseAgentDefinition(content, fallbackName);
275
+ if (!parsed) {
276
+ agents.delete(fallbackName);
277
+ diagnostics.push({
278
+ code: "invalid-role-definition",
279
+ message: `Role definition must start with frontmatter: ${filePath}`,
280
+ path: filePath,
281
+ agentName: fallbackName,
282
+ });
283
+ }
284
+ else
285
+ agents.set(parsed.name, {
286
+ ...parsed,
287
+ source,
288
+ path: filePath,
289
+ role: runtimeRole(parsed, source),
290
+ });
291
+ }
292
+ };
293
+ // Registered role packs are the entire package layer; the host ships no roles.
294
+ const discovered = discoverRolePackPaths(options.onRolePackDiscovered);
295
+ diagnostics.push(...discovered.diagnostics);
296
+ const contributed = new Map();
297
+ for (const registeredPath of discovered.paths) {
298
+ if (!existsSync(registeredPath)) {
299
+ diagnostics.push({
300
+ code: "missing-role-pack-path",
301
+ message: `Registered role-pack path does not exist: ${registeredPath}`,
302
+ path: registeredPath,
303
+ });
304
+ continue;
305
+ }
306
+ let metadata;
307
+ let roleFiles;
308
+ try {
309
+ metadata = findPackageMetadata(registeredPath);
310
+ roleFiles = listMarkdownFiles(registeredPath);
311
+ }
312
+ catch (error) {
313
+ diagnostics.push({
314
+ code: "unreadable-role-pack-path",
315
+ message: `Cannot read registered role-pack path ${registeredPath}: ${error instanceof Error ? error.message : String(error)}`,
316
+ path: registeredPath,
317
+ });
318
+ continue;
319
+ }
320
+ if (roleFiles.length === 0 && statSync(registeredPath).isFile()) {
321
+ diagnostics.push({
322
+ code: "invalid-role-pack-file",
323
+ message: `Registered role-pack file must use the .md extension: ${registeredPath}`,
324
+ path: registeredPath,
325
+ provider: metadata.provider,
326
+ });
327
+ continue;
328
+ }
329
+ for (const filePath of roleFiles) {
330
+ const fallbackName = basename(filePath, ".md");
331
+ let content;
332
+ try {
333
+ content = normalizeRoleText(readFileSync(filePath, "utf8"));
334
+ }
335
+ catch (error) {
336
+ diagnostics.push({
337
+ code: "unreadable-role-definition",
338
+ message: `Cannot read role definition ${filePath}: ${error instanceof Error ? error.message : String(error)}`,
339
+ path: filePath,
340
+ agentName: fallbackName,
341
+ provider: metadata.provider,
342
+ });
343
+ continue;
344
+ }
345
+ const legacyDiagnostic = legacyExternalCliDiagnostic(content, fallbackName, filePath);
346
+ if (legacyDiagnostic) {
347
+ diagnostics.push({ ...legacyDiagnostic, provider: metadata.provider });
348
+ continue;
349
+ }
350
+ const capabilityDiagnostic = invalidCapabilityDeclarationDiagnostic(content, fallbackName, filePath);
351
+ if (capabilityDiagnostic) {
352
+ diagnostics.push({
353
+ ...capabilityDiagnostic,
354
+ provider: metadata.provider,
355
+ });
356
+ continue;
357
+ }
358
+ const parsed = parseAgentDefinition(content, fallbackName);
359
+ if (!parsed) {
360
+ diagnostics.push({
361
+ code: "invalid-role-definition",
362
+ message: `Role definition must start with frontmatter: ${filePath}`,
363
+ path: filePath,
364
+ agentName: fallbackName,
365
+ provider: metadata.provider,
366
+ });
367
+ continue;
368
+ }
369
+ if (parsed.name !== fallbackName) {
370
+ diagnostics.push({
371
+ code: "role-name-mismatch",
372
+ message: `Role name "${parsed.name}" must match filename "${fallbackName}" in ${filePath}`,
373
+ path: filePath,
374
+ agentName: fallbackName,
375
+ provider: metadata.provider,
376
+ });
377
+ continue;
378
+ }
379
+ if (!parsed.description) {
380
+ diagnostics.push({
381
+ code: "missing-role-description",
382
+ message: `Role "${parsed.name}" must declare a description in ${filePath}`,
383
+ path: filePath,
384
+ agentName: parsed.name,
385
+ provider: metadata.provider,
386
+ });
387
+ continue;
388
+ }
389
+ const definitions = contributed.get(parsed.name) ?? [];
390
+ definitions.push({
391
+ ...parsed,
392
+ source: "package",
393
+ path: filePath,
394
+ ...metadata,
395
+ role: runtimeRole(parsed, "package", metadata.providerVersion),
396
+ });
397
+ contributed.set(parsed.name, definitions);
398
+ }
399
+ }
400
+ for (const [name, definitions] of contributed) {
401
+ if (definitions.length > 1) {
402
+ const providers = definitions
403
+ .map((definition) => definition.provider ?? definition.path)
404
+ .sort((left, right) => left.localeCompare(right))
405
+ .join(", ");
406
+ diagnostics.push({
407
+ code: "duplicate-package-role",
408
+ message: `Role "${name}" is contributed by multiple role packs: ${providers}. It stays unavailable until only one pack provides it; use a global or project definition for an intentional override.`,
409
+ agentName: name,
410
+ });
411
+ continue;
412
+ }
413
+ agents.set(name, definitions[0]);
414
+ }
415
+ addDirectory(join(options.agentConfigDir, "agents"), "global");
416
+ addDirectory(join(options.cwd, ".pi", "agents"), "project");
417
+ return { agents: [...agents.values()], diagnostics };
418
+ }
419
+ export function discoverAgentDefinitions(options) {
420
+ return discoverAgentCatalog(options).agents;
421
+ }
422
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../maestro/core/roles/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename, dirname, isAbsolute, join, resolve } from \"node:path\";\nimport { readdirSync, readFileSync, existsSync, statSync } from \"node:fs\";\nimport { isString } from \"../config/type-guards.ts\";\nimport { isThinkingLevel, type ThinkingLevel } from \"../routing.ts\";\nimport type { Role } from \"../types.ts\";\n\nexport type SubagentSessionMode = \"standalone\" | \"lineage-only\" | \"fork\";\n\nexport interface AgentDefaults {\n\tmodel?: string;\n\ttools?: string;\n\tskills?: string;\n\tthinking?: ThinkingLevel;\n\tdenyTools?: string;\n\tspawning?: boolean;\n\tselfSpawn?: boolean;\n\tpersistent?: boolean;\n\tautoExit?: boolean;\n\tinteractive?: boolean;\n\tsystemPromptMode?: \"append\" | \"replace\";\n\tsessionMode?: SubagentSessionMode;\n\tcwd?: string;\n\tbody?: string;\n\tdisableModelInvocation?: boolean;\n}\n\ntype AgentSource = \"package\" | \"global\" | \"project\";\n\ninterface AgentDefinition extends AgentDefaults {\n\tname: string;\n\tdescription?: string;\n\tdisableModelInvocation: boolean;\n}\n\nexport interface ListedAgentDefinition extends AgentDefinition {\n\t/** Runtime role plus the unchanged raw listing/validation metadata above. */\n\trole: Role;\n\tsource: AgentSource;\n\tpath: string;\n\tprovider?: string;\n\tproviderVersion?: string;\n}\n\nexport interface AgentDiagnostic {\n\tcode: string;\n\tmessage: string;\n\tpath?: string;\n\tagentName?: string;\n\tprovider?: string;\n}\n\nexport interface AgentCatalog {\n\tagents: ListedAgentDefinition[];\n\tdiagnostics: AgentDiagnostic[];\n}\n\nexport const ROLE_PACK_DISCOVERY_EVENT = \"pi-herdr-subagents:roles:discover:v1\";\n\nexport interface RolePackDiscoveryEvent {\n\tapiVersion: 1;\n\tregister(path: string): void;\n}\n\nexport interface RoleDiscoveryOptions {\n\tagentConfigDir: string;\n\tcwd: string;\n\tonRolePackDiscovered?(event: RolePackDiscoveryEvent): void;\n}\n\nfunction runtimeRole(\n\tdefinition: AgentDefinition,\n\tsource: AgentSource,\n\tproviderVersion?: string,\n): Role {\n\treturn {\n\t\tname: definition.name,\n\t\tversion: providerVersion ?? \"1\",\n\t\tdescription: definition.description ?? \"\",\n\t\tsystemPrompt: definition.body ?? \"\",\n\t\tallowedTools:\n\t\t\tdefinition.tools\n\t\t\t\t?.split(\",\")\n\t\t\t\t.map((tool) => tool.trim())\n\t\t\t\t.filter(Boolean) ?? [],\n\t\tdefaults: {\n\t\t\tmodel: definition.model,\n\t\t\tthinking: definition.thinking,\n\t\t\tsessionMode: definition.sessionMode,\n\t\t\tspawning: definition.spawning,\n\t\t\tselfSpawn: definition.selfSpawn,\n\t\t\tautoExit: definition.autoExit,\n\t\t\tinteractive: definition.interactive,\n\t\t\tpersistent: definition.persistent,\n\t\t\tsystemPromptMode: definition.systemPromptMode,\n\t\t\tdenyTools: definition.denyTools\n\t\t\t\t?.split(\",\")\n\t\t\t\t.map((tool) => tool.trim())\n\t\t\t\t.filter(Boolean),\n\t\t\tskills: definition.skills\n\t\t\t\t?.split(\",\")\n\t\t\t\t.map((skill) => skill.trim())\n\t\t\t\t.filter(Boolean),\n\t\t\tcwd: definition.cwd,\n\t\t},\n\t\tsource,\n\t};\n}\n\nfunction getFrontmatterLines(frontmatter: string, key: string): string[] {\n\tconst prefix = `${key}:`;\n\treturn frontmatter\n\t\t.split(\"\\n\")\n\t\t.filter((candidate) => candidate.startsWith(prefix));\n}\n\nfunction getFrontmatterValue(\n\tfrontmatter: string,\n\tkey: string,\n): string | undefined {\n\tconst line = getFrontmatterLines(frontmatter, key)[0];\n\treturn line?.slice(`${key}:`.length).trim() || undefined;\n}\n\ntype CapabilityField =\n\t| \"tools\"\n\t| \"deny-tools\"\n\t| \"spawning\"\n\t| \"self-spawn\"\n\t| \"persistent\";\n\ninterface CapabilityDeclarations {\n\tcanonical: string[];\n\thasNoncanonical: boolean;\n}\n\nfunction isCapabilityDeclaration(\n\tline: string,\n\tfield: CapabilityField,\n): boolean {\n\tconst trimmed = line.trimStart();\n\tconst colon = trimmed.indexOf(\":\");\n\tif (colon === -1) return false;\n\tconst key = trimmed.slice(0, colon).trim();\n\treturn key === field || key === `\"${field}\"` || key === `'${field}'`;\n}\n\nfunction getCapabilityDeclarations(\n\tfrontmatter: string,\n\tfield: CapabilityField,\n): CapabilityDeclarations {\n\tconst canonicalPrefix = `${field}:`;\n\tconst lines = frontmatter.split(\"\\n\");\n\treturn {\n\t\tcanonical: lines.filter((line) => line.startsWith(canonicalPrefix)),\n\t\thasNoncanonical: lines.some(\n\t\t\t(line) =>\n\t\t\t\tisCapabilityDeclaration(line, field) &&\n\t\t\t\t!line.startsWith(canonicalPrefix),\n\t\t),\n\t};\n}\n\nfunction validateCapabilityDeclarations(\n\tfrontmatter: string,\n): string | undefined {\n\tfor (const field of [\n\t\t\"tools\",\n\t\t\"deny-tools\",\n\t\t\"spawning\",\n\t\t\"self-spawn\",\n\t\t\"persistent\",\n\t] as const) {\n\t\tconst declarations = getCapabilityDeclarations(frontmatter, field);\n\t\tif (declarations.hasNoncanonical) {\n\t\t\treturn `${field} must use an unquoted, unindented key written exactly as ${field}:`;\n\t\t}\n\t\tif (declarations.canonical.length > 1) {\n\t\t\treturn `${field} may be declared only once.`;\n\t\t}\n\t\tif (declarations.canonical.length === 0) continue;\n\n\t\tconst value = declarations.canonical[0].slice(`${field}:`.length).trim();\n\t\tif (\n\t\t\tfield === \"spawning\" ||\n\t\t\tfield === \"self-spawn\" ||\n\t\t\tfield === \"persistent\"\n\t\t) {\n\t\t\tif (value !== \"true\" && value !== \"false\") {\n\t\t\t\treturn `${field} must be true or false.`;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (\n\t\t\t!value ||\n\t\t\tvalue.startsWith(\"[\") ||\n\t\t\tvalue.startsWith(\"{\") ||\n\t\t\tvalue.startsWith(\"|\") ||\n\t\t\tvalue.startsWith(\">\") ||\n\t\t\tvalue.includes(\"#\") ||\n\t\t\tvalue.includes('\"') ||\n\t\t\tvalue.includes(\"'\") ||\n\t\t\tvalue.split(\",\").some((entry) => !entry.trim())\n\t\t) {\n\t\t\treturn `${field} must use a non-empty comma-separated scalar; YAML lists and containers, comments and quotes are unsupported.`;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction parseOptionalBoolean(value: string | undefined): boolean | undefined {\n\treturn value == null ? undefined : value === \"true\";\n}\n\nfunction parseSessionMode(\n\tvalue: string | undefined,\n): SubagentSessionMode | undefined {\n\tif (value === \"standalone\" || value === \"lineage-only\" || value === \"fork\") {\n\t\treturn value;\n\t}\n\treturn undefined;\n}\n\nfunction normalizeRoleText(content: string): string {\n\treturn content.replace(/^\\uFEFF/, \"\").replace(/\\r\\n/g, \"\\n\");\n}\n\nfunction parseAgentDefinition(\n\tcontent: string,\n\tfallbackName: string,\n): AgentDefinition | null {\n\tconst match = content.match(/^---\\n([\\s\\S]*?)\\n---/);\n\tif (!match) return null;\n\n\tconst frontmatter = match[1];\n\tconst body = content.replace(/^---\\n[\\s\\S]*?\\n---\\n*/, \"\").trim();\n\tconst systemPromptMode = getFrontmatterValue(frontmatter, \"system-prompt\");\n\tconst thinking = getFrontmatterValue(frontmatter, \"thinking\");\n\n\treturn {\n\t\tname: getFrontmatterValue(frontmatter, \"name\") ?? fallbackName,\n\t\tdescription: getFrontmatterValue(frontmatter, \"description\"),\n\t\tmodel: getFrontmatterValue(frontmatter, \"model\"),\n\t\ttools: getFrontmatterValue(frontmatter, \"tools\"),\n\t\tsystemPromptMode:\n\t\t\tsystemPromptMode === \"replace\"\n\t\t\t\t? \"replace\"\n\t\t\t\t: systemPromptMode === \"append\"\n\t\t\t\t\t? \"append\"\n\t\t\t\t\t: undefined,\n\t\tskills:\n\t\t\tgetFrontmatterValue(frontmatter, \"skills\") ??\n\t\t\tgetFrontmatterValue(frontmatter, \"skill\"),\n\t\tthinking: thinking && isThinkingLevel(thinking) ? thinking : undefined,\n\t\tdenyTools: getFrontmatterValue(frontmatter, \"deny-tools\"),\n\t\tspawning: parseOptionalBoolean(\n\t\t\tgetFrontmatterValue(frontmatter, \"spawning\"),\n\t\t),\n\t\tselfSpawn: parseOptionalBoolean(\n\t\t\tgetFrontmatterValue(frontmatter, \"self-spawn\"),\n\t\t),\n\t\tpersistent: parseOptionalBoolean(\n\t\t\tgetFrontmatterValue(frontmatter, \"persistent\"),\n\t\t),\n\t\tautoExit: parseOptionalBoolean(\n\t\t\tgetFrontmatterValue(frontmatter, \"auto-exit\"),\n\t\t),\n\t\tinteractive: parseOptionalBoolean(\n\t\t\tgetFrontmatterValue(frontmatter, \"interactive\"),\n\t\t),\n\t\tsessionMode: parseSessionMode(\n\t\t\tgetFrontmatterValue(frontmatter, \"session-mode\"),\n\t\t),\n\t\tcwd: getFrontmatterValue(frontmatter, \"cwd\"),\n\t\tbody: body || undefined,\n\t\tdisableModelInvocation:\n\t\t\tgetFrontmatterValue(\n\t\t\t\tfrontmatter,\n\t\t\t\t\"disable-model-invocation\",\n\t\t\t)?.toLowerCase() === \"true\",\n\t};\n}\n\nfunction invalidCapabilityDeclarationDiagnostic(\n\tcontent: string,\n\tagentName: string,\n\tpath: string,\n): AgentDiagnostic | null {\n\tconst match = content.match(/^---\\n([\\s\\S]*?)\\n---/);\n\tif (!match) return null;\n\tconst resolvedAgentName = getFrontmatterValue(match[1], \"name\") ?? agentName;\n\tconst error = validateCapabilityDeclarations(match[1]);\n\tif (!error) return null;\n\treturn {\n\t\tcode: \"invalid-capability-declaration\",\n\t\tmessage: `Role \"${resolvedAgentName}\" has an invalid capability declaration in ${path}: ${error} Use documented comma-separated tools or deny-tools values, true or false for spawning or self-spawn, or omit the field.`,\n\t\tpath,\n\t\tagentName: resolvedAgentName,\n\t};\n}\n\nfunction legacyExternalCliDiagnostic(\n\tcontent: string,\n\tagentName: string,\n\tpath: string,\n): AgentDiagnostic | null {\n\tconst match = content.match(/^---\\n([\\s\\S]*?)\\n---/);\n\tconst cli = match ? getFrontmatterValue(match[1], \"cli\") : undefined;\n\tif (!match || !cli) return null;\n\tconst resolvedAgentName = getFrontmatterValue(match[1], \"name\") ?? agentName;\n\treturn {\n\t\tcode: \"external-cli-unsupported\",\n\t\tmessage: `Role \"${resolvedAgentName}\" requests external CLI \"${cli}\" in ${path}. pi-herdr-agents is Pi-only; remove the cli and cli-model fields and select Claude through an authenticated Pi provider/model ID.`,\n\t\tpath,\n\t\tagentName: resolvedAgentName,\n\t};\n}\n\nfunction listMarkdownFiles(path: string): string[] {\n\tconst stat = statSync(path);\n\tif (stat.isFile()) return path.endsWith(\".md\") ? [path] : [];\n\tif (!stat.isDirectory()) return [];\n\treturn readdirSync(path)\n\t\t.filter((entry) => entry.endsWith(\".md\"))\n\t\t.sort((left, right) => left.localeCompare(right))\n\t\t.map((entry) => join(path, entry));\n}\n\ninterface PackageMetadata {\n\tprovider?: string;\n\tproviderVersion?: string;\n}\n\nfunction findPackageMetadata(path: string): PackageMetadata {\n\tlet current = statSync(path).isDirectory() ? path : dirname(path);\n\twhile (true) {\n\t\tconst packagePath = join(current, \"package.json\");\n\t\tif (existsSync(packagePath)) {\n\t\t\ttry {\n\t\t\t\tconst pkg = JSON.parse(readFileSync(packagePath, \"utf8\"));\n\t\t\t\treturn {\n\t\t\t\t\tprovider: isString(pkg.name) ? pkg.name : undefined,\n\t\t\t\t\tproviderVersion: isString(pkg.version) ? pkg.version : undefined,\n\t\t\t\t};\n\t\t\t} catch {\n\t\t\t\treturn {};\n\t\t\t}\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) return {};\n\t\tcurrent = parent;\n\t}\n}\n\ninterface RolePackDiscoveryResult {\n\tpaths: string[];\n\tdiagnostics: AgentDiagnostic[];\n}\n\nexport function discoverRolePackPaths(\n\tonRolePackDiscovered?: RoleDiscoveryOptions[\"onRolePackDiscovered\"],\n): RolePackDiscoveryResult {\n\tconst paths = new Set<string>();\n\tconst diagnostics: AgentDiagnostic[] = [];\n\tif (!onRolePackDiscovered) return { paths: [], diagnostics };\n\n\ttry {\n\t\tonRolePackDiscovered({\n\t\t\tapiVersion: 1,\n\t\t\tregister(path: string) {\n\t\t\t\tif (!isString(path) || !isAbsolute(path)) {\n\t\t\t\t\tdiagnostics.push({\n\t\t\t\t\t\tcode: \"invalid-role-pack-path\",\n\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\"Role packs must register an absolute file or directory path.\",\n\t\t\t\t\t});\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tpaths.add(resolve(path));\n\t\t\t},\n\t\t});\n\t} catch (error) {\n\t\tdiagnostics.push({\n\t\t\tcode: \"role-pack-discovery-failed\",\n\t\t\tmessage: `Role-pack discovery failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t});\n\t}\n\n\treturn { paths: [...paths], diagnostics };\n}\n\nexport function discoverAgentCatalog(\n\toptions: RoleDiscoveryOptions,\n): AgentCatalog {\n\tconst agents = new Map<string, ListedAgentDefinition>();\n\tconst diagnostics: AgentDiagnostic[] = [];\n\n\tconst addDirectory = (path: string, source: AgentSource) => {\n\t\tif (!existsSync(path)) return;\n\t\tfor (const filePath of listMarkdownFiles(path)) {\n\t\t\tconst fallbackName = basename(filePath, \".md\");\n\t\t\tlet content: string;\n\t\t\ttry {\n\t\t\t\tcontent = normalizeRoleText(readFileSync(filePath, \"utf8\"));\n\t\t\t} catch (error) {\n\t\t\t\tagents.delete(fallbackName);\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"unreadable-role-definition\",\n\t\t\t\t\tmessage: `Cannot read role definition ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tagentName: fallbackName,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst legacyDiagnostic = legacyExternalCliDiagnostic(\n\t\t\t\tcontent,\n\t\t\t\tfallbackName,\n\t\t\t\tfilePath,\n\t\t\t);\n\t\t\tif (legacyDiagnostic) {\n\t\t\t\tdiagnostics.push(legacyDiagnostic);\n\t\t\t\tagents.delete(legacyDiagnostic.agentName ?? fallbackName);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst capabilityDiagnostic = invalidCapabilityDeclarationDiagnostic(\n\t\t\t\tcontent,\n\t\t\t\tfallbackName,\n\t\t\t\tfilePath,\n\t\t\t);\n\t\t\tif (capabilityDiagnostic) {\n\t\t\t\tdiagnostics.push(capabilityDiagnostic);\n\t\t\t\tagents.delete(capabilityDiagnostic.agentName ?? fallbackName);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst parsed = parseAgentDefinition(content, fallbackName);\n\t\t\tif (!parsed) {\n\t\t\t\tagents.delete(fallbackName);\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"invalid-role-definition\",\n\t\t\t\t\tmessage: `Role definition must start with frontmatter: ${filePath}`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tagentName: fallbackName,\n\t\t\t\t});\n\t\t\t} else\n\t\t\t\tagents.set(parsed.name, {\n\t\t\t\t\t...parsed,\n\t\t\t\t\tsource,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\trole: runtimeRole(parsed, source),\n\t\t\t\t});\n\t\t}\n\t};\n\n\t// Registered role packs are the entire package layer; the host ships no roles.\n\tconst discovered = discoverRolePackPaths(options.onRolePackDiscovered);\n\tdiagnostics.push(...discovered.diagnostics);\n\tconst contributed = new Map<string, ListedAgentDefinition[]>();\n\tfor (const registeredPath of discovered.paths) {\n\t\tif (!existsSync(registeredPath)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"missing-role-pack-path\",\n\t\t\t\tmessage: `Registered role-pack path does not exist: ${registeredPath}`,\n\t\t\t\tpath: registeredPath,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet metadata: ReturnType<typeof findPackageMetadata>;\n\t\tlet roleFiles: string[];\n\t\ttry {\n\t\t\tmetadata = findPackageMetadata(registeredPath);\n\t\t\troleFiles = listMarkdownFiles(registeredPath);\n\t\t} catch (error) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"unreadable-role-pack-path\",\n\t\t\t\tmessage: `Cannot read registered role-pack path ${registeredPath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\tpath: registeredPath,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tif (roleFiles.length === 0 && statSync(registeredPath).isFile()) {\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"invalid-role-pack-file\",\n\t\t\t\tmessage: `Registered role-pack file must use the .md extension: ${registeredPath}`,\n\t\t\t\tpath: registeredPath,\n\t\t\t\tprovider: metadata.provider,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const filePath of roleFiles) {\n\t\t\tconst fallbackName = basename(filePath, \".md\");\n\t\t\tlet content: string;\n\t\t\ttry {\n\t\t\t\tcontent = normalizeRoleText(readFileSync(filePath, \"utf8\"));\n\t\t\t} catch (error) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"unreadable-role-definition\",\n\t\t\t\t\tmessage: `Cannot read role definition ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tagentName: fallbackName,\n\t\t\t\t\tprovider: metadata.provider,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst legacyDiagnostic = legacyExternalCliDiagnostic(\n\t\t\t\tcontent,\n\t\t\t\tfallbackName,\n\t\t\t\tfilePath,\n\t\t\t);\n\t\t\tif (legacyDiagnostic) {\n\t\t\t\tdiagnostics.push({ ...legacyDiagnostic, provider: metadata.provider });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst capabilityDiagnostic = invalidCapabilityDeclarationDiagnostic(\n\t\t\t\tcontent,\n\t\t\t\tfallbackName,\n\t\t\t\tfilePath,\n\t\t\t);\n\t\t\tif (capabilityDiagnostic) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\t...capabilityDiagnostic,\n\t\t\t\t\tprovider: metadata.provider,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst parsed = parseAgentDefinition(content, fallbackName);\n\t\t\tif (!parsed) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"invalid-role-definition\",\n\t\t\t\t\tmessage: `Role definition must start with frontmatter: ${filePath}`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tagentName: fallbackName,\n\t\t\t\t\tprovider: metadata.provider,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (parsed.name !== fallbackName) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"role-name-mismatch\",\n\t\t\t\t\tmessage: `Role name \"${parsed.name}\" must match filename \"${fallbackName}\" in ${filePath}`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tagentName: fallbackName,\n\t\t\t\t\tprovider: metadata.provider,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!parsed.description) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"missing-role-description\",\n\t\t\t\t\tmessage: `Role \"${parsed.name}\" must declare a description in ${filePath}`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tagentName: parsed.name,\n\t\t\t\t\tprovider: metadata.provider,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst definitions = contributed.get(parsed.name) ?? [];\n\t\t\tdefinitions.push({\n\t\t\t\t...parsed,\n\t\t\t\tsource: \"package\",\n\t\t\t\tpath: filePath,\n\t\t\t\t...metadata,\n\t\t\t\trole: runtimeRole(parsed, \"package\", metadata.providerVersion),\n\t\t\t});\n\t\t\tcontributed.set(parsed.name, definitions);\n\t\t}\n\t}\n\n\tfor (const [name, definitions] of contributed) {\n\t\tif (definitions.length > 1) {\n\t\t\tconst providers = definitions\n\t\t\t\t.map((definition) => definition.provider ?? definition.path)\n\t\t\t\t.sort((left, right) => left.localeCompare(right))\n\t\t\t\t.join(\", \");\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"duplicate-package-role\",\n\t\t\t\tmessage: `Role \"${name}\" is contributed by multiple role packs: ${providers}. It stays unavailable until only one pack provides it; use a global or project definition for an intentional override.`,\n\t\t\t\tagentName: name,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tagents.set(name, definitions[0]);\n\t}\n\n\taddDirectory(join(options.agentConfigDir, \"agents\"), \"global\");\n\taddDirectory(join(options.cwd, \".pi\", \"agents\"), \"project\");\n\n\treturn { agents: [...agents.values()], diagnostics };\n}\n\nexport function discoverAgentDefinitions(\n\toptions: RoleDiscoveryOptions,\n): ListedAgentDefinition[] {\n\treturn discoverAgentCatalog(options).agents;\n}\n"]}