@nubl/maestro 0.0.1 → 0.1.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 (398) hide show
  1. package/README.md +56 -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,51 @@
1
+ /** Largest SKILL.md injected. */
2
+ export declare const SKILL_FILE_MAX_BYTES: number;
3
+ /** Largest combined size of all skill files read, and of all injected blocks. */
4
+ export declare const SKILLS_TOTAL_MAX_BYTES: number;
5
+ /** The fields of Pi's loaded `Skill` this module reads. */
6
+ interface LoadedSkill {
7
+ name: string;
8
+ filePath: string;
9
+ baseDir: string;
10
+ }
11
+ interface BeforeAgentStart {
12
+ systemPromptOptions: {
13
+ skills?: readonly LoadedSkill[];
14
+ };
15
+ }
16
+ /** The node:fs calls used for bounded reads; injectable for tests. */
17
+ export interface SkillFileSystem {
18
+ statSync(path: string): {
19
+ isFile(): boolean;
20
+ size: number;
21
+ };
22
+ openSync(path: string, flags: "r"): number;
23
+ readSync(fd: number, buffer: Buffer, offset: number, length: number, position: number): number;
24
+ closeSync(fd: number): void;
25
+ }
26
+ /**
27
+ * A `before_agent_start` handler that injects the declared skills once, on
28
+ * its first call, and nothing afterwards.
29
+ */
30
+ export declare function createDeclaredSkillsInjector(names: readonly string[], fs?: SkillFileSystem): (event: BeforeAgentStart) => {
31
+ message: {
32
+ customType: string;
33
+ content: string;
34
+ display: boolean;
35
+ details: {
36
+ injected: number;
37
+ notLoaded: string[];
38
+ skipped: string[];
39
+ };
40
+ };
41
+ } | undefined;
42
+ /**
43
+ * Inject the skills named in {@link DECLARED_SKILLS_ENV} on this process's
44
+ * first run. The first run consumes the variable, so a reloaded extension or
45
+ * a process this child starts never injects them again.
46
+ */
47
+ export declare function registerDeclaredSkills(pi: {
48
+ on(event: "before_agent_start", handler: (event: BeforeAgentStart) => ReturnType<ReturnType<typeof createDeclaredSkillsInjector>>): void;
49
+ }, env?: NodeJS.ProcessEnv): void;
50
+ export {};
51
+ //# sourceMappingURL=declared-skills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"declared-skills.d.ts","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/declared-skills.ts"],"names":[],"mappings":"AAmBA,iCAAiC;AACjC,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAC9C,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,QAAa,CAAC;AAIjD,2DAA2D;AAC3D,UAAU,WAAW;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACzB,mBAAmB,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;KAAE,CAAC;CACzD;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,IAAI,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,MAAM,CAAC;IAC3C,QAAQ,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,MAAM,CAAC;IACV,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAmDD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,EAAE,GAAE,eAAwB,IAGpB,OAAO,gBAAgB;;;;;;;;;;;cAkE/B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,EAAE,EAAE;IACH,EAAE,CACD,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,CACR,KAAK,EAAE,gBAAgB,KACnB,UAAU,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,GAC9D,IAAI,CAAC;CACR,EACD,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,IAAI,CAQN"}
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Declared skills, resolved by the child's own Pi.
3
+ *
4
+ * The parent exports only the role's declared skill names
5
+ * ({@link DECLARED_SKILLS_ENV}). Pi in this child has already discovered,
6
+ * trust-checked, ignore-filtered and package-filtered its skills; the first
7
+ * `before_agent_start` of a fresh launch looks each declared name up there,
8
+ * by exact name, and returns one message carrying the `<skill>` blocks Pi
9
+ * itself writes for `/skill:name`. Pi adds that message to the run's first
10
+ * provider request, beside the task. A name Pi did not load is noted, never
11
+ * searched for elsewhere.
12
+ */
13
+ import * as nodeFs from "node:fs";
14
+ import { stripFrontmatter } from "@earendil-works/pi-coding-agent";
15
+ import { DECLARED_SKILLS_ENV, parseDeclaredSkillsEnv, } from "../../../core/declared-skills.js";
16
+ /** Largest SKILL.md injected. */
17
+ export const SKILL_FILE_MAX_BYTES = 64 * 1024;
18
+ /** Largest combined size of all skill files read, and of all injected blocks. */
19
+ export const SKILLS_TOTAL_MAX_BYTES = 256 * 1024;
20
+ const MESSAGE_TYPE = "pi-herdr-agents:declared-skills";
21
+ const kib = (bytes) => `${Math.ceil(bytes / 1024)} KiB`;
22
+ const overTotal = (bytesRead) => ({
23
+ skipped: `would pass the ${kib(SKILLS_TOTAL_MAX_BYTES)} total limit`,
24
+ bytesRead,
25
+ });
26
+ /**
27
+ * The file's text, or why it was skipped. Stats first and never reads more
28
+ * than the smaller of the per-skill limit and the remaining total budget, plus
29
+ * one byte, even if the file grows.
30
+ */
31
+ function readSkillFile(filePath, fs, budget) {
32
+ const stats = fs.statSync(filePath);
33
+ if (!stats.isFile())
34
+ return { skipped: "is not a regular file", bytesRead: 0 };
35
+ const overLimit = (bytes, bytesRead) => ({
36
+ skipped: `(${kib(bytes)}) is over the ${kib(SKILL_FILE_MAX_BYTES)} per-skill limit`,
37
+ bytesRead,
38
+ });
39
+ if (stats.size > SKILL_FILE_MAX_BYTES)
40
+ return overLimit(stats.size, 0);
41
+ if (stats.size > budget)
42
+ return overTotal(0);
43
+ const cap = Math.min(SKILL_FILE_MAX_BYTES, budget);
44
+ const buffer = Buffer.alloc(cap + 1);
45
+ const fd = fs.openSync(filePath, "r");
46
+ let length = 0;
47
+ try {
48
+ for (;;) {
49
+ const n = fs.readSync(fd, buffer, length, buffer.length - length, length);
50
+ if (n === 0 || (length += n) === buffer.length)
51
+ break;
52
+ }
53
+ }
54
+ finally {
55
+ fs.closeSync(fd);
56
+ }
57
+ if (length > cap)
58
+ return cap === SKILL_FILE_MAX_BYTES
59
+ ? overLimit(length, length)
60
+ : overTotal(length);
61
+ return { text: buffer.toString("utf8", 0, length), bytesRead: length };
62
+ }
63
+ /**
64
+ * A `before_agent_start` handler that injects the declared skills once, on
65
+ * its first call, and nothing afterwards.
66
+ */
67
+ export function createDeclaredSkillsInjector(names, fs = nodeFs) {
68
+ let fired = false;
69
+ return (event) => {
70
+ if (fired)
71
+ return undefined;
72
+ fired = true;
73
+ if (names.length === 0)
74
+ return undefined;
75
+ const loaded = event.systemPromptOptions.skills ?? [];
76
+ const blocks = [];
77
+ const notLoaded = [];
78
+ const skipped = [];
79
+ let total = 0;
80
+ let readBudget = SKILLS_TOTAL_MAX_BYTES;
81
+ for (const name of names) {
82
+ const skill = loaded.find((candidate) => candidate.name === name);
83
+ if (!skill) {
84
+ notLoaded.push(name);
85
+ continue;
86
+ }
87
+ let read;
88
+ try {
89
+ read = readSkillFile(skill.filePath, fs, readBudget);
90
+ }
91
+ catch (error) {
92
+ read = {
93
+ skipped: `could not be read (${error instanceof Error ? error.message : String(error)})`,
94
+ bytesRead: 0,
95
+ };
96
+ }
97
+ readBudget -= read.bytesRead;
98
+ if ("skipped" in read) {
99
+ skipped.push(`${name} ${read.skipped}`);
100
+ continue;
101
+ }
102
+ // The block Pi writes when it expands `/skill:name`.
103
+ const block = `<skill name="${skill.name}" location="${skill.filePath}">\n` +
104
+ `References are relative to ${skill.baseDir}.\n\n` +
105
+ `${stripFrontmatter(read.text).trim()}\n</skill>`;
106
+ const bytes = Buffer.byteLength(block);
107
+ if (total + bytes > SKILLS_TOTAL_MAX_BYTES) {
108
+ skipped.push(`${name} would pass the ${kib(SKILLS_TOTAL_MAX_BYTES)} total limit`);
109
+ continue;
110
+ }
111
+ total += bytes;
112
+ blocks.push(block);
113
+ }
114
+ const notes = [
115
+ notLoaded.length > 0
116
+ ? `declared skills not loaded by Pi: ${notLoaded.join(", ")}.`
117
+ : "",
118
+ skipped.length > 0
119
+ ? `declared skills skipped: ${skipped.join("; ")}.`
120
+ : "",
121
+ ].filter(Boolean);
122
+ const content = [
123
+ ...blocks,
124
+ ...(notes.length > 0 ? [`Host note: ${notes.join(" ")}`] : []),
125
+ ].join("\n\n");
126
+ return {
127
+ message: {
128
+ customType: MESSAGE_TYPE,
129
+ content,
130
+ display: false,
131
+ details: { injected: blocks.length, notLoaded, skipped },
132
+ },
133
+ };
134
+ };
135
+ }
136
+ /**
137
+ * Inject the skills named in {@link DECLARED_SKILLS_ENV} on this process's
138
+ * first run. The first run consumes the variable, so a reloaded extension or
139
+ * a process this child starts never injects them again.
140
+ */
141
+ export function registerDeclaredSkills(pi, env = process.env) {
142
+ const inject = createDeclaredSkillsInjector(parseDeclaredSkillsEnv(env[DECLARED_SKILLS_ENV]));
143
+ pi.on("before_agent_start", (event) => {
144
+ delete env[DECLARED_SKILLS_ENV];
145
+ return inject(event);
146
+ });
147
+ }
148
+ //# sourceMappingURL=declared-skills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"declared-skills.js","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/declared-skills.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Declared skills, resolved by the child's own Pi.\n *\n * The parent exports only the role's declared skill names\n * ({@link DECLARED_SKILLS_ENV}). Pi in this child has already discovered,\n * trust-checked, ignore-filtered and package-filtered its skills; the first\n * `before_agent_start` of a fresh launch looks each declared name up there,\n * by exact name, and returns one message carrying the `<skill>` blocks Pi\n * itself writes for `/skill:name`. Pi adds that message to the run's first\n * provider request, beside the task. A name Pi did not load is noted, never\n * searched for elsewhere.\n */\nimport * as nodeFs from \"node:fs\";\nimport { stripFrontmatter } from \"@earendil-works/pi-coding-agent\";\nimport {\n\tDECLARED_SKILLS_ENV,\n\tparseDeclaredSkillsEnv,\n} from \"../../../core/declared-skills.ts\";\n\n/** Largest SKILL.md injected. */\nexport const SKILL_FILE_MAX_BYTES = 64 * 1024;\n/** Largest combined size of all skill files read, and of all injected blocks. */\nexport const SKILLS_TOTAL_MAX_BYTES = 256 * 1024;\n\nconst MESSAGE_TYPE = \"pi-herdr-agents:declared-skills\";\n\n/** The fields of Pi's loaded `Skill` this module reads. */\ninterface LoadedSkill {\n\tname: string;\n\tfilePath: string;\n\tbaseDir: string;\n}\n\ninterface BeforeAgentStart {\n\tsystemPromptOptions: { skills?: readonly LoadedSkill[] };\n}\n\n/** The node:fs calls used for bounded reads; injectable for tests. */\nexport interface SkillFileSystem {\n\tstatSync(path: string): { isFile(): boolean; size: number };\n\topenSync(path: string, flags: \"r\"): number;\n\treadSync(\n\t\tfd: number,\n\t\tbuffer: Buffer,\n\t\toffset: number,\n\t\tlength: number,\n\t\tposition: number,\n\t): number;\n\tcloseSync(fd: number): void;\n}\n\nconst kib = (bytes: number) => `${Math.ceil(bytes / 1024)} KiB`;\n\ntype SkillRead =\n\t| { text: string; bytesRead: number }\n\t| { skipped: string; bytesRead: number };\n\nconst overTotal = (bytesRead: number): SkillRead => ({\n\tskipped: `would pass the ${kib(SKILLS_TOTAL_MAX_BYTES)} total limit`,\n\tbytesRead,\n});\n\n/**\n * The file's text, or why it was skipped. Stats first and never reads more\n * than the smaller of the per-skill limit and the remaining total budget, plus\n * one byte, even if the file grows.\n */\nfunction readSkillFile(\n\tfilePath: string,\n\tfs: SkillFileSystem,\n\tbudget: number,\n): SkillRead {\n\tconst stats = fs.statSync(filePath);\n\tif (!stats.isFile())\n\t\treturn { skipped: \"is not a regular file\", bytesRead: 0 };\n\tconst overLimit = (bytes: number, bytesRead: number): SkillRead => ({\n\t\tskipped: `(${kib(bytes)}) is over the ${kib(SKILL_FILE_MAX_BYTES)} per-skill limit`,\n\t\tbytesRead,\n\t});\n\tif (stats.size > SKILL_FILE_MAX_BYTES) return overLimit(stats.size, 0);\n\tif (stats.size > budget) return overTotal(0);\n\tconst cap = Math.min(SKILL_FILE_MAX_BYTES, budget);\n\tconst buffer = Buffer.alloc(cap + 1);\n\tconst fd = fs.openSync(filePath, \"r\");\n\tlet length = 0;\n\ttry {\n\t\tfor (;;) {\n\t\t\tconst n = fs.readSync(fd, buffer, length, buffer.length - length, length);\n\t\t\tif (n === 0 || (length += n) === buffer.length) break;\n\t\t}\n\t} finally {\n\t\tfs.closeSync(fd);\n\t}\n\tif (length > cap)\n\t\treturn cap === SKILL_FILE_MAX_BYTES\n\t\t\t? overLimit(length, length)\n\t\t\t: overTotal(length);\n\treturn { text: buffer.toString(\"utf8\", 0, length), bytesRead: length };\n}\n\n/**\n * A `before_agent_start` handler that injects the declared skills once, on\n * its first call, and nothing afterwards.\n */\nexport function createDeclaredSkillsInjector(\n\tnames: readonly string[],\n\tfs: SkillFileSystem = nodeFs,\n) {\n\tlet fired = false;\n\treturn (event: BeforeAgentStart) => {\n\t\tif (fired) return undefined;\n\t\tfired = true;\n\t\tif (names.length === 0) return undefined;\n\t\tconst loaded = event.systemPromptOptions.skills ?? [];\n\t\tconst blocks: string[] = [];\n\t\tconst notLoaded: string[] = [];\n\t\tconst skipped: string[] = [];\n\t\tlet total = 0;\n\t\tlet readBudget = SKILLS_TOTAL_MAX_BYTES;\n\t\tfor (const name of names) {\n\t\t\tconst skill = loaded.find((candidate) => candidate.name === name);\n\t\t\tif (!skill) {\n\t\t\t\tnotLoaded.push(name);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tlet read: SkillRead;\n\t\t\ttry {\n\t\t\t\tread = readSkillFile(skill.filePath, fs, readBudget);\n\t\t\t} catch (error) {\n\t\t\t\tread = {\n\t\t\t\t\tskipped: `could not be read (${error instanceof Error ? error.message : String(error)})`,\n\t\t\t\t\tbytesRead: 0,\n\t\t\t\t};\n\t\t\t}\n\t\t\treadBudget -= read.bytesRead;\n\t\t\tif (\"skipped\" in read) {\n\t\t\t\tskipped.push(`${name} ${read.skipped}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// The block Pi writes when it expands `/skill:name`.\n\t\t\tconst block =\n\t\t\t\t`<skill name=\"${skill.name}\" location=\"${skill.filePath}\">\\n` +\n\t\t\t\t`References are relative to ${skill.baseDir}.\\n\\n` +\n\t\t\t\t`${stripFrontmatter(read.text).trim()}\\n</skill>`;\n\t\t\tconst bytes = Buffer.byteLength(block);\n\t\t\tif (total + bytes > SKILLS_TOTAL_MAX_BYTES) {\n\t\t\t\tskipped.push(\n\t\t\t\t\t`${name} would pass the ${kib(SKILLS_TOTAL_MAX_BYTES)} total limit`,\n\t\t\t\t);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\ttotal += bytes;\n\t\t\tblocks.push(block);\n\t\t}\n\t\tconst notes = [\n\t\t\tnotLoaded.length > 0\n\t\t\t\t? `declared skills not loaded by Pi: ${notLoaded.join(\", \")}.`\n\t\t\t\t: \"\",\n\t\t\tskipped.length > 0\n\t\t\t\t? `declared skills skipped: ${skipped.join(\"; \")}.`\n\t\t\t\t: \"\",\n\t\t].filter(Boolean);\n\t\tconst content = [\n\t\t\t...blocks,\n\t\t\t...(notes.length > 0 ? [`Host note: ${notes.join(\" \")}`] : []),\n\t\t].join(\"\\n\\n\");\n\t\treturn {\n\t\t\tmessage: {\n\t\t\t\tcustomType: MESSAGE_TYPE,\n\t\t\t\tcontent,\n\t\t\t\tdisplay: false,\n\t\t\t\tdetails: { injected: blocks.length, notLoaded, skipped },\n\t\t\t},\n\t\t};\n\t};\n}\n\n/**\n * Inject the skills named in {@link DECLARED_SKILLS_ENV} on this process's\n * first run. The first run consumes the variable, so a reloaded extension or\n * a process this child starts never injects them again.\n */\nexport function registerDeclaredSkills(\n\tpi: {\n\t\ton(\n\t\t\tevent: \"before_agent_start\",\n\t\t\thandler: (\n\t\t\t\tevent: BeforeAgentStart,\n\t\t\t) => ReturnType<ReturnType<typeof createDeclaredSkillsInjector>>,\n\t\t): void;\n\t},\n\tenv: NodeJS.ProcessEnv = process.env,\n): void {\n\tconst inject = createDeclaredSkillsInjector(\n\t\tparseDeclaredSkillsEnv(env[DECLARED_SKILLS_ENV]),\n\t);\n\tpi.on(\"before_agent_start\", (event) => {\n\t\tdelete env[DECLARED_SKILLS_ENV];\n\t\treturn inject(event);\n\t});\n}\n"]}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Asks a child that ended a run without subagent_done whether its task is
3
+ * complete. A child without auto-exit stays open until it calls subagent_done,
4
+ * and one that forgets leaves its caller waiting on a session that has stopped
5
+ * working.
6
+ */
7
+ export declare const DONE_NUDGE_DELAY_MS = 3000;
8
+ export declare const DONE_NUDGE_MESSAGE: string;
9
+ export interface DoneNudgeContext {
10
+ isIdle(): boolean;
11
+ hasPendingMessages(): boolean;
12
+ ui?: {
13
+ getEditorText?(): string;
14
+ };
15
+ }
16
+ export interface DoneNudgeOptions {
17
+ send(message: string): void;
18
+ isBusy(): boolean;
19
+ }
20
+ export interface DoneNudge {
21
+ runStarting(): void;
22
+ settled(messages: readonly {
23
+ role?: string;
24
+ stopReason?: string;
25
+ }[] | undefined, aborted: boolean, ctx: DoneNudgeContext): void;
26
+ cancel(): void;
27
+ }
28
+ /** A run that ended on its own, not by an abort or a provider error. */
29
+ export declare function endedNormally(messages: readonly {
30
+ role?: string;
31
+ stopReason?: string;
32
+ }[] | undefined): boolean;
33
+ /**
34
+ * Speaks at most once per run that something else started, so a child that
35
+ * answers "waiting" is not asked again until new input arrives.
36
+ */
37
+ export declare function createDoneNudge(options: DoneNudgeOptions): DoneNudge;
38
+ //# sourceMappingURL=done-nudge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"done-nudge.d.ts","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/done-nudge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC,eAAO,MAAM,kBAAkB,QAKE,CAAC;AAElC,MAAM,WAAW,gBAAgB;IAChC,MAAM,IAAI,OAAO,CAAC;IAClB,kBAAkB,IAAI,OAAO,CAAC;IAC9B,EAAE,CAAC,EAAE;QAAE,aAAa,CAAC,IAAI,MAAM,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACzB,WAAW,IAAI,IAAI,CAAC;IACpB,OAAO,CACN,QAAQ,EAAE,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,EACvE,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,gBAAgB,GACnB,IAAI,CAAC;IACR,MAAM,IAAI,IAAI,CAAC;CACf;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,GACrE,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA2CpE"}
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Asks a child that ended a run without subagent_done whether its task is
3
+ * complete. A child without auto-exit stays open until it calls subagent_done,
4
+ * and one that forgets leaves its caller waiting on a session that has stopped
5
+ * working.
6
+ */
7
+ export const DONE_NUDGE_DELAY_MS = 3_000;
8
+ export const DONE_NUDGE_MESSAGE = "Is your task complete? If it is, call subagent_done now without writing " +
9
+ "anything else, so your previous answer stays the summary returned to " +
10
+ "your caller. If you are waiting for something, such as the user's " +
11
+ "answer or your own subagents, say what you are waiting for in one line " +
12
+ "and do not call subagent_done.";
13
+ /** A run that ended on its own, not by an abort or a provider error. */
14
+ export function endedNormally(messages) {
15
+ if (!messages)
16
+ return false;
17
+ for (let i = messages.length - 1; i >= 0; i--) {
18
+ const message = messages[i];
19
+ if (message?.role !== "assistant")
20
+ continue;
21
+ return message.stopReason !== "aborted" && message.stopReason !== "error";
22
+ }
23
+ return false;
24
+ }
25
+ /**
26
+ * Speaks at most once per run that something else started, so a child that
27
+ * answers "waiting" is not asked again until new input arrives.
28
+ */
29
+ export function createDoneNudge(options) {
30
+ let armed = false;
31
+ // Set when the nudge speaks, so the run it starts does not re-arm it. A flag,
32
+ // not a text match: another extension's input handler may rewrite the prompt.
33
+ let nudgeInFlight = false;
34
+ let timer;
35
+ function cancel() {
36
+ if (timer === undefined)
37
+ return;
38
+ clearTimeout(timer);
39
+ timer = undefined;
40
+ }
41
+ function fire(ctx) {
42
+ timer = undefined;
43
+ if (!armed)
44
+ return;
45
+ try {
46
+ if (!ctx.isIdle() || ctx.hasPendingMessages())
47
+ return;
48
+ if (ctx.ui?.getEditorText?.()?.trim())
49
+ return;
50
+ }
51
+ catch {
52
+ // A context that cannot answer is not one to interrupt.
53
+ return;
54
+ }
55
+ if (options.isBusy())
56
+ return;
57
+ armed = false;
58
+ nudgeInFlight = true;
59
+ options.send(DONE_NUDGE_MESSAGE);
60
+ }
61
+ return {
62
+ runStarting() {
63
+ cancel();
64
+ armed = !nudgeInFlight;
65
+ nudgeInFlight = false;
66
+ },
67
+ settled(messages, aborted, ctx) {
68
+ cancel();
69
+ if (!armed || aborted || !endedNormally(messages))
70
+ return;
71
+ timer = setTimeout(() => fire(ctx), DONE_NUDGE_DELAY_MS);
72
+ timer.unref?.();
73
+ },
74
+ cancel,
75
+ };
76
+ }
77
+ //# sourceMappingURL=done-nudge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"done-nudge.js","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/done-nudge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAC9B,0EAA0E;IAC1E,uEAAuE;IACvE,oEAAoE;IACpE,yEAAyE;IACzE,gCAAgC,CAAC;AAuBlC,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAC5B,QAAuE;IAEvE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,OAAO,EAAE,IAAI,KAAK,WAAW;YAAE,SAAS;QAC5C,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACxD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,8EAA8E;IAC9E,8EAA8E;IAC9E,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,KAAgD,CAAC;IAErD,SAAS,MAAM;QACd,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,SAAS,CAAC;IACnB,CAAC;IAED,SAAS,IAAI,CAAC,GAAqB;QAClC,KAAK,GAAG,SAAS,CAAC;QAClB,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC;YACJ,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,kBAAkB,EAAE;gBAAE,OAAO;YACtD,IAAI,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE;gBAAE,OAAO;QAC/C,CAAC;QAAC,MAAM,CAAC;YACR,wDAAwD;YACxD,OAAO;QACR,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO;QAC7B,KAAK,GAAG,KAAK,CAAC;QACd,aAAa,GAAG,IAAI,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACN,WAAW;YACV,MAAM,EAAE,CAAC;YACT,KAAK,GAAG,CAAC,aAAa,CAAC;YACvB,aAAa,GAAG,KAAK,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG;YAC7B,MAAM,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAC1D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACzD,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QACjB,CAAC;QACD,MAAM;KACN,CAAC;AACH,CAAC","sourcesContent":["/**\n * Asks a child that ended a run without subagent_done whether its task is\n * complete. A child without auto-exit stays open until it calls subagent_done,\n * and one that forgets leaves its caller waiting on a session that has stopped\n * working.\n */\n\nexport const DONE_NUDGE_DELAY_MS = 3_000;\n\nexport const DONE_NUDGE_MESSAGE =\n\t\"Is your task complete? If it is, call subagent_done now without writing \" +\n\t\"anything else, so your previous answer stays the summary returned to \" +\n\t\"your caller. If you are waiting for something, such as the user's \" +\n\t\"answer or your own subagents, say what you are waiting for in one line \" +\n\t\"and do not call subagent_done.\";\n\nexport interface DoneNudgeContext {\n\tisIdle(): boolean;\n\thasPendingMessages(): boolean;\n\tui?: { getEditorText?(): string };\n}\n\nexport interface DoneNudgeOptions {\n\tsend(message: string): void;\n\tisBusy(): boolean;\n}\n\nexport interface DoneNudge {\n\trunStarting(): void;\n\tsettled(\n\t\tmessages: readonly { role?: string; stopReason?: string }[] | undefined,\n\t\taborted: boolean,\n\t\tctx: DoneNudgeContext,\n\t): void;\n\tcancel(): void;\n}\n\n/** A run that ended on its own, not by an abort or a provider error. */\nexport function endedNormally(\n\tmessages: readonly { role?: string; stopReason?: string }[] | undefined,\n): boolean {\n\tif (!messages) return false;\n\tfor (let i = messages.length - 1; i >= 0; i--) {\n\t\tconst message = messages[i];\n\t\tif (message?.role !== \"assistant\") continue;\n\t\treturn message.stopReason !== \"aborted\" && message.stopReason !== \"error\";\n\t}\n\treturn false;\n}\n\n/**\n * Speaks at most once per run that something else started, so a child that\n * answers \"waiting\" is not asked again until new input arrives.\n */\nexport function createDoneNudge(options: DoneNudgeOptions): DoneNudge {\n\tlet armed = false;\n\t// Set when the nudge speaks, so the run it starts does not re-arm it. A flag,\n\t// not a text match: another extension's input handler may rewrite the prompt.\n\tlet nudgeInFlight = false;\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\n\tfunction cancel() {\n\t\tif (timer === undefined) return;\n\t\tclearTimeout(timer);\n\t\ttimer = undefined;\n\t}\n\n\tfunction fire(ctx: DoneNudgeContext) {\n\t\ttimer = undefined;\n\t\tif (!armed) return;\n\t\ttry {\n\t\t\tif (!ctx.isIdle() || ctx.hasPendingMessages()) return;\n\t\t\tif (ctx.ui?.getEditorText?.()?.trim()) return;\n\t\t} catch {\n\t\t\t// A context that cannot answer is not one to interrupt.\n\t\t\treturn;\n\t\t}\n\t\tif (options.isBusy()) return;\n\t\tarmed = false;\n\t\tnudgeInFlight = true;\n\t\toptions.send(DONE_NUDGE_MESSAGE);\n\t}\n\n\treturn {\n\t\trunStarting() {\n\t\t\tcancel();\n\t\t\tarmed = !nudgeInFlight;\n\t\t\tnudgeInFlight = false;\n\t\t},\n\t\tsettled(messages, aborted, ctx) {\n\t\t\tcancel();\n\t\t\tif (!armed || aborted || !endedNormally(messages)) return;\n\t\t\ttimer = setTimeout(() => fire(ctx), DONE_NUDGE_DELAY_MS);\n\t\t\ttimer.unref?.();\n\t\t},\n\t\tcancel,\n\t};\n}\n"]}
@@ -0,0 +1,3 @@
1
+ /** Protocol-only entry for emitted consumers, without terminal presentation. */
2
+ export { default } from "./protocol.ts";
3
+ //# sourceMappingURL=entry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/entry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Protocol-only entry for emitted consumers, without terminal presentation. */
2
+ export { default } from "./protocol.js";
3
+ //# sourceMappingURL=entry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/entry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/** Protocol-only entry for emitted consumers, without terminal presentation. */\nexport { default } from \"./protocol.ts\";\n"]}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Extension loaded into sub-agents.
3
+ * - Shows agent identity + available tools as a compact styled widget above the editor
4
+ * - Provides a `subagent_done` tool for interactive agents to self-terminate
5
+ */
6
+ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
7
+ import { consumePersistentTaskInbox } from "../session.ts";
8
+ import { type ChildAcceptReport } from "../../../core/accept.ts";
9
+ export declare function shouldMarkUserTookOver(agentStarted: boolean): boolean;
10
+ export declare function shouldAutoExitOnAgentEnd(_userTookOver: boolean, messages: any[] | undefined, runAborted?: boolean): boolean;
11
+ export interface SubagentErrorInfo {
12
+ errorMessage: string;
13
+ stopReason: "error";
14
+ }
15
+ /**
16
+ * If the last assistant message in the turn ended with `stopReason: "error"`
17
+ * (typically auto-retry exhausted on an overload / rate limit / server error),
18
+ * return its error info so the parent orchestrator can surface a clear
19
+ * failure instead of silently treating the run as completed.
20
+ *
21
+ * Returns `null` when the latest assistant turn completed normally or was
22
+ * aborted by the user (handled separately by shouldAutoExitOnAgentEnd).
23
+ */
24
+ export declare function findLatestAssistantError(messages: any[] | undefined): SubagentErrorInfo | null;
25
+ export declare function buildCompletionSidecar(messages: any[] | undefined, accept?: ChildAcceptReport): {
26
+ type: "done";
27
+ accept?: ChildAcceptReport;
28
+ } | {
29
+ type: "error";
30
+ errorMessage: string;
31
+ stopReason: "error";
32
+ };
33
+ export declare function buildPersistentTaskEvent(task: string, generation: string): {
34
+ version: 1;
35
+ type: "task-done";
36
+ task: string;
37
+ generation: string;
38
+ at: string;
39
+ };
40
+ export declare function isPersistentStopDirective(inbox: ReturnType<typeof consumePersistentTaskInbox>): boolean;
41
+ export declare function parseDeniedTools(rawValue: string | undefined): string[];
42
+ /**
43
+ * A managed worktree child names its own process at load from immutable
44
+ * kernel facts, which Pi's process-title rewrite cannot alter.
45
+ */
46
+ export declare function recordProcessIdentity(id: string | undefined, sessionFile: string | undefined, file?: string | undefined): void;
47
+ export type ChildPresentationHook = (ctx: ExtensionContext, identity: {
48
+ subagentName: string;
49
+ subagentAgent: string;
50
+ toolNames: string[];
51
+ denied: string[];
52
+ }) => void;
53
+ export declare function createChildExtension(renderWidget?: ChildPresentationHook): (pi: ExtensionAPI) => void;
54
+ declare const _default: (pi: ExtensionAPI) => void;
55
+ export default _default;
56
+ //# sourceMappingURL=protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,YAAY,EACZ,gBAAgB,EAChB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAEN,0BAA0B,EAG1B,MAAM,eAAe,CAAC;AAWvB,OAAO,EAEN,KAAK,iBAAiB,EACtB,MAAM,yBAAyB,CAAC;AASjC,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAErE;AAED,wBAAgB,wBAAwB,CACvC,aAAa,EAAE,OAAO,EACtB,QAAQ,EAAE,GAAG,EAAE,GAAG,SAAS,EAC3B,UAAU,UAAQ,GAChB,OAAO,CAsBT;AAED,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,GAAG,EAAE,GAAG,SAAS,GACzB,iBAAiB,GAAG,IAAI,CAe1B;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,GAAG,EAAE,GAAG,SAAS,EAC3B,MAAM,CAAC,EAAE,iBAAiB,GAExB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAK9D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;;;;;;EAQxE;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,GAClD,OAAO,CAET;AAyBD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAKvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,qBAAuC,GACzC,IAAI,CAYN;AAED,MAAM,MAAM,qBAAqB,GAAG,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB,KACG,IAAI,CAAC;AAEV,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,qBAAqB,IACjC,IAAI,YAAY,UAkcvD;6BAlc2C,YAAY;AAocxD,wBAAsC"}