@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,161 @@
1
+ import { spawn } from "node:child_process";
2
+ import { readFileSync, statSync } from "node:fs";
3
+ import { ACCEPT_CAPTURE_CHARS, ACCEPT_KILL_GRACE_MS, normalizeAcceptSpec, } from "../../core/accept.js";
4
+ import { trackAcceptCheck } from "./accept-groups.js";
5
+ import { signalProcessTree } from "./process-tree.js";
6
+ /** Wait this long for inherited pipes to close after the shell exits. */
7
+ const PIPE_CLOSE_GRACE_MS = 1_000;
8
+ /**
9
+ * The check's environment: the caller's, without `PI_SUBAGENT_*`, so a nested
10
+ * Pi inside the check never acts as this child.
11
+ */
12
+ export function acceptCheckEnv(env = process.env) {
13
+ return Object.fromEntries(Object.entries(env).filter(([key]) => !key.startsWith("PI_SUBAGENT_")));
14
+ }
15
+ /** Whether the check's shell is still running; its pid is only ours until then. */
16
+ function shellRunning(child) {
17
+ return child.exitCode === null && child.signalCode === null;
18
+ }
19
+ function signalGroup(child, signal, tree) {
20
+ if (child.pid === undefined)
21
+ return;
22
+ // Detached: the shell leads its own process group (POSIX), or its tree is
23
+ // ended by `taskkill /T` (Windows, only while the shell lives: after it
24
+ // exits the pid may belong to someone else). Fall back to the shell alone.
25
+ signalProcessTree(child.pid, signal, () => {
26
+ try {
27
+ child.kill(signal);
28
+ }
29
+ catch {
30
+ /* already gone */
31
+ }
32
+ }, { ...tree, alive: () => shellRunning(child) });
33
+ }
34
+ /**
35
+ * `sh -c <run>` in `cwd`, asynchronously, with a timeout. Keeps the last 64 KiB
36
+ * of combined output. A timeout or abort sends SIGTERM to the process group
37
+ * and SIGKILL after the grace; whatever is left of the group is killed once
38
+ * the shell exits. Windows has no groups or signals, so `taskkill /T /F` ends
39
+ * the tree while the shell still runs (never after it exits: the pid may then
40
+ * belong to an unrelated process) and any stop there is immediate. After the shell exits, the check waits briefly for
41
+ * inherited pipes to close; a timeout or abort then ends it at once. The
42
+ * group is tracked under `owner` until it is killed (`accept-groups.ts`).
43
+ */
44
+ export function createAcceptRunner(processTree = {}) {
45
+ return (options) => runCheck(options, processTree);
46
+ }
47
+ export const runAcceptCommand = createAcceptRunner();
48
+ const runCheck = (options, tree) => new Promise((resolve) => {
49
+ try {
50
+ if (!statSync(options.cwd).isDirectory())
51
+ return resolve({ kind: "cwd-missing", output: "" });
52
+ }
53
+ catch {
54
+ return resolve({ kind: "cwd-missing", output: "" });
55
+ }
56
+ if (options.signal?.aborted)
57
+ return resolve({ kind: "aborted", output: "" });
58
+ let output = "";
59
+ const append = (chunk) => {
60
+ output = (output + chunk.toString("utf8")).slice(-ACCEPT_CAPTURE_CHARS);
61
+ };
62
+ let child;
63
+ try {
64
+ child = spawn("sh", ["-c", options.run], {
65
+ cwd: options.cwd,
66
+ env: options.env ?? acceptCheckEnv(),
67
+ detached: true,
68
+ // Detached on Windows opens a console window unless it is hidden.
69
+ windowsHide: true,
70
+ stdio: ["ignore", "pipe", "pipe"],
71
+ });
72
+ }
73
+ catch (error) {
74
+ return resolve({
75
+ kind: "spawn-error",
76
+ error: error instanceof Error ? error.message : String(error),
77
+ output: "",
78
+ });
79
+ }
80
+ let stopped;
81
+ let exit;
82
+ let done = false;
83
+ const timers = [];
84
+ // A later stop (an owner's shutdown) only brings the SIGKILL forward.
85
+ const stop = (reason, graceMs = options.killGraceMs ?? ACCEPT_KILL_GRACE_MS) => {
86
+ if (done)
87
+ return;
88
+ const first = !stopped;
89
+ stopped ??= reason;
90
+ // The shell is gone; its group may still hold the pipes: kill it now.
91
+ if (exit)
92
+ return finish(fromExit());
93
+ if (first)
94
+ signalGroup(child, "SIGTERM", tree);
95
+ timers.push(setTimeout(() => signalGroup(child, "SIGKILL", tree), graceMs));
96
+ };
97
+ let settle = () => { };
98
+ const untrack = child.pid === undefined
99
+ ? () => { }
100
+ : trackAcceptCheck({
101
+ pgid: child.pid,
102
+ processTree: { ...tree, alive: () => shellRunning(child) },
103
+ owner: options.owner,
104
+ terminate: (graceMs) => stop("aborted", graceMs),
105
+ finished: new Promise((resolve) => {
106
+ settle = resolve;
107
+ }),
108
+ });
109
+ const onAbort = () => stop("aborted");
110
+ const finish = (result) => {
111
+ if (done)
112
+ return;
113
+ done = true;
114
+ for (const timer of timers)
115
+ clearTimeout(timer);
116
+ options.signal?.removeEventListener("abort", onAbort);
117
+ // A bounded check leaves nothing running behind it.
118
+ signalGroup(child, "SIGKILL", tree);
119
+ untrack();
120
+ settle();
121
+ child.stdout?.destroy();
122
+ child.stderr?.destroy();
123
+ resolve(result);
124
+ };
125
+ const fromExit = () => {
126
+ if (stopped)
127
+ return { kind: stopped, output };
128
+ if (exit?.code !== null && exit?.code !== undefined)
129
+ return { kind: "exit", exitCode: exit.code, output };
130
+ return { kind: "signal", signal: exit?.signal ?? "unknown", output };
131
+ };
132
+ child.stdout?.on("data", append);
133
+ child.stderr?.on("data", append);
134
+ child.on("error", (error) => finish({ kind: "spawn-error", error: error.message, output }));
135
+ child.on("exit", (code, signal) => {
136
+ exit = { code, signal };
137
+ // A stopped check does not wait for its pipes.
138
+ if (stopped)
139
+ return finish(fromExit());
140
+ timers.push(setTimeout(() => finish(fromExit()), PIPE_CLOSE_GRACE_MS));
141
+ });
142
+ child.on("close", () => {
143
+ if (exit)
144
+ finish(fromExit());
145
+ });
146
+ timers.push(setTimeout(() => stop("timeout"), options.timeoutMs));
147
+ options.signal?.addEventListener("abort", onAbort, { once: true });
148
+ });
149
+ /** The child's spec file; unreadable or invalid means no child loop. */
150
+ export function readAcceptSpecFile(file) {
151
+ if (!file)
152
+ return undefined;
153
+ try {
154
+ const { version, ...request } = JSON.parse(readFileSync(file, "utf8"));
155
+ return version === 1 ? normalizeAcceptSpec(request) : undefined;
156
+ }
157
+ catch {
158
+ return undefined;
159
+ }
160
+ }
161
+ //# sourceMappingURL=accept-runner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accept-runner.js","sourceRoot":"","sources":["../../../../maestro/adapters/pi/accept-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { readFileSync, statSync } from \"node:fs\";\nimport {\n\tACCEPT_CAPTURE_CHARS,\n\tACCEPT_KILL_GRACE_MS,\n\tnormalizeAcceptSpec,\n\ttype AcceptCommandResult,\n\ttype AcceptSpec,\n} from \"../../core/accept.ts\";\nimport { trackAcceptCheck, type AcceptCheckOwner } from \"./accept-groups.ts\";\nimport { signalProcessTree, type ProcessTreeOptions } from \"./process-tree.ts\";\n\nexport interface AcceptCommandOptions {\n\trun: string;\n\tcwd: string;\n\ttimeoutMs: number;\n\t/** Aborting stops the check like a timeout and reports `aborted`. */\n\tsignal?: AbortSignal;\n\t/** SIGTERM to the process group (POSIX), then SIGKILL after this grace. */\n\tkillGraceMs?: number;\n\tenv?: NodeJS.ProcessEnv;\n\t/** Stops this check at its shutdown (`accept-groups.ts`). */\n\towner?: AcceptCheckOwner;\n}\n\n/** Runs one accept check; injectable so tests need no real commands. */\nexport type AcceptRunner = (\n\toptions: AcceptCommandOptions,\n) => Promise<AcceptCommandResult>;\n\n/** Wait this long for inherited pipes to close after the shell exits. */\nconst PIPE_CLOSE_GRACE_MS = 1_000;\n\n/**\n * The check's environment: the caller's, without `PI_SUBAGENT_*`, so a nested\n * Pi inside the check never acts as this child.\n */\nexport function acceptCheckEnv(\n\tenv: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n\treturn Object.fromEntries(\n\t\tObject.entries(env).filter(([key]) => !key.startsWith(\"PI_SUBAGENT_\")),\n\t);\n}\n\n/** Whether the check's shell is still running; its pid is only ours until then. */\nfunction shellRunning(child: ChildProcess): boolean {\n\treturn child.exitCode === null && child.signalCode === null;\n}\n\nfunction signalGroup(\n\tchild: ChildProcess,\n\tsignal: NodeJS.Signals,\n\ttree: ProcessTreeOptions,\n): void {\n\tif (child.pid === undefined) return;\n\t// Detached: the shell leads its own process group (POSIX), or its tree is\n\t// ended by `taskkill /T` (Windows, only while the shell lives: after it\n\t// exits the pid may belong to someone else). Fall back to the shell alone.\n\tsignalProcessTree(\n\t\tchild.pid,\n\t\tsignal,\n\t\t() => {\n\t\t\ttry {\n\t\t\t\tchild.kill(signal);\n\t\t\t} catch {\n\t\t\t\t/* already gone */\n\t\t\t}\n\t\t},\n\t\t{ ...tree, alive: () => shellRunning(child) },\n\t);\n}\n\n/**\n * `sh -c <run>` in `cwd`, asynchronously, with a timeout. Keeps the last 64 KiB\n * of combined output. A timeout or abort sends SIGTERM to the process group\n * and SIGKILL after the grace; whatever is left of the group is killed once\n * the shell exits. Windows has no groups or signals, so `taskkill /T /F` ends\n * the tree while the shell still runs (never after it exits: the pid may then\n * belong to an unrelated process) and any stop there is immediate. After the shell exits, the check waits briefly for\n * inherited pipes to close; a timeout or abort then ends it at once. The\n * group is tracked under `owner` until it is killed (`accept-groups.ts`).\n */\nexport function createAcceptRunner(\n\tprocessTree: ProcessTreeOptions = {},\n): AcceptRunner {\n\treturn (options) => runCheck(options, processTree);\n}\n\nexport const runAcceptCommand: AcceptRunner = createAcceptRunner();\n\nconst runCheck = (\n\toptions: AcceptCommandOptions,\n\ttree: ProcessTreeOptions,\n): Promise<AcceptCommandResult> =>\n\tnew Promise((resolve) => {\n\t\ttry {\n\t\t\tif (!statSync(options.cwd).isDirectory())\n\t\t\t\treturn resolve({ kind: \"cwd-missing\", output: \"\" });\n\t\t} catch {\n\t\t\treturn resolve({ kind: \"cwd-missing\", output: \"\" });\n\t\t}\n\t\tif (options.signal?.aborted)\n\t\t\treturn resolve({ kind: \"aborted\", output: \"\" });\n\t\tlet output = \"\";\n\t\tconst append = (chunk: Buffer) => {\n\t\t\toutput = (output + chunk.toString(\"utf8\")).slice(-ACCEPT_CAPTURE_CHARS);\n\t\t};\n\t\tlet child: ChildProcess;\n\t\ttry {\n\t\t\tchild = spawn(\"sh\", [\"-c\", options.run], {\n\t\t\t\tcwd: options.cwd,\n\t\t\t\tenv: options.env ?? acceptCheckEnv(),\n\t\t\t\tdetached: true,\n\t\t\t\t// Detached on Windows opens a console window unless it is hidden.\n\t\t\t\twindowsHide: true,\n\t\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treturn resolve({\n\t\t\t\tkind: \"spawn-error\",\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\toutput: \"\",\n\t\t\t});\n\t\t}\n\t\tlet stopped: \"timeout\" | \"aborted\" | undefined;\n\t\tlet exit:\n\t\t\t| { code: number | null; signal: NodeJS.Signals | null }\n\t\t\t| undefined;\n\t\tlet done = false;\n\t\tconst timers: NodeJS.Timeout[] = [];\n\t\t// A later stop (an owner's shutdown) only brings the SIGKILL forward.\n\t\tconst stop = (\n\t\t\treason: \"timeout\" | \"aborted\",\n\t\t\tgraceMs = options.killGraceMs ?? ACCEPT_KILL_GRACE_MS,\n\t\t) => {\n\t\t\tif (done) return;\n\t\t\tconst first = !stopped;\n\t\t\tstopped ??= reason;\n\t\t\t// The shell is gone; its group may still hold the pipes: kill it now.\n\t\t\tif (exit) return finish(fromExit());\n\t\t\tif (first) signalGroup(child, \"SIGTERM\", tree);\n\t\t\ttimers.push(\n\t\t\t\tsetTimeout(() => signalGroup(child, \"SIGKILL\", tree), graceMs),\n\t\t\t);\n\t\t};\n\t\tlet settle = () => {};\n\t\tconst untrack =\n\t\t\tchild.pid === undefined\n\t\t\t\t? () => {}\n\t\t\t\t: trackAcceptCheck({\n\t\t\t\t\t\tpgid: child.pid,\n\t\t\t\t\t\tprocessTree: { ...tree, alive: () => shellRunning(child) },\n\t\t\t\t\t\towner: options.owner,\n\t\t\t\t\t\tterminate: (graceMs) => stop(\"aborted\", graceMs),\n\t\t\t\t\t\tfinished: new Promise<void>((resolve) => {\n\t\t\t\t\t\t\tsettle = resolve;\n\t\t\t\t\t\t}),\n\t\t\t\t\t});\n\t\tconst onAbort = () => stop(\"aborted\");\n\t\tconst finish = (result: AcceptCommandResult) => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tfor (const timer of timers) clearTimeout(timer);\n\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t// A bounded check leaves nothing running behind it.\n\t\t\tsignalGroup(child, \"SIGKILL\", tree);\n\t\t\tuntrack();\n\t\t\tsettle();\n\t\t\tchild.stdout?.destroy();\n\t\t\tchild.stderr?.destroy();\n\t\t\tresolve(result);\n\t\t};\n\t\tconst fromExit = (): AcceptCommandResult => {\n\t\t\tif (stopped) return { kind: stopped, output };\n\t\t\tif (exit?.code !== null && exit?.code !== undefined)\n\t\t\t\treturn { kind: \"exit\", exitCode: exit.code, output };\n\t\t\treturn { kind: \"signal\", signal: exit?.signal ?? \"unknown\", output };\n\t\t};\n\t\tchild.stdout?.on(\"data\", append);\n\t\tchild.stderr?.on(\"data\", append);\n\t\tchild.on(\"error\", (error) =>\n\t\t\tfinish({ kind: \"spawn-error\", error: error.message, output }),\n\t\t);\n\t\tchild.on(\"exit\", (code, signal) => {\n\t\t\texit = { code, signal };\n\t\t\t// A stopped check does not wait for its pipes.\n\t\t\tif (stopped) return finish(fromExit());\n\t\t\ttimers.push(setTimeout(() => finish(fromExit()), PIPE_CLOSE_GRACE_MS));\n\t\t});\n\t\tchild.on(\"close\", () => {\n\t\t\tif (exit) finish(fromExit());\n\t\t});\n\t\ttimers.push(setTimeout(() => stop(\"timeout\"), options.timeoutMs));\n\t\toptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n\n/** The child's spec file; unreadable or invalid means no child loop. */\nexport function readAcceptSpecFile(\n\tfile: string | undefined,\n): AcceptSpec | undefined {\n\tif (!file) return undefined;\n\ttry {\n\t\tconst { version, ...request } = JSON.parse(readFileSync(file, \"utf8\"));\n\t\treturn version === 1 ? normalizeAcceptSpec(request) : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}
@@ -0,0 +1,39 @@
1
+ import type { ActivityReadResult, SubagentActivityState } from "../../core/types.ts";
2
+ export type SubagentShutdownReason = "quit" | "reload" | "new" | "resume" | "fork";
3
+ export interface SubagentActivityRecorder {
4
+ sessionStart(): void;
5
+ input(): void;
6
+ beforeAgentStart(): void;
7
+ agentStart(): void;
8
+ agentEndWaiting(): void;
9
+ agentEndDone(): void;
10
+ turnStart(turnIndex?: number): void;
11
+ turnEnd(turnIndex?: number): void;
12
+ beforeProviderRequest(): void;
13
+ afterProviderResponse(): void;
14
+ messageUpdate(messageEventType?: string): void;
15
+ toolExecutionStart(toolCallId?: string, toolName?: string): void;
16
+ toolCall(toolCallId?: string, toolName?: string): void;
17
+ toolExecutionUpdate(toolCallId?: string, toolName?: string): void;
18
+ toolResult(toolCallId?: string, toolName?: string): void;
19
+ toolExecutionEnd(toolCallId?: string, toolName?: string): void;
20
+ callerPing(): void;
21
+ subagentDone(): void;
22
+ /** A persistent specialist received its next task: leave the done snapshot. */
23
+ taskStart(): void;
24
+ sessionShutdown(reason: SubagentShutdownReason): void;
25
+ }
26
+ export declare function getSubagentActivityFile(artifactDir: string, runningChildId: string): string;
27
+ export declare function readSubagentActivityFile(activityFile: string, expectedRunningChildId: string): ActivityReadResult;
28
+ export declare function writeSubagentActivityFile(activityFile: string, activity: SubagentActivityState): void;
29
+ export declare function createSubagentActivityRecorder(params: {
30
+ runningChildId?: string;
31
+ activityFile?: string;
32
+ /**
33
+ * A persistent specialist outlives each task: `done` ends the current task's
34
+ * recording instead of the file's, and `taskStart` resumes it.
35
+ */
36
+ persistent?: boolean;
37
+ now?: () => number;
38
+ }): SubagentActivityRecorder;
39
+ //# sourceMappingURL=activity-file.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity-file.d.ts","sourceRoot":"","sources":["../../../../maestro/adapters/pi/activity-file.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACX,kBAAkB,EAIlB,qBAAqB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAC/B,MAAM,GACN,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,CAAC;AAEV,MAAM,WAAW,wBAAwB;IACxC,YAAY,IAAI,IAAI,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,IAAI,IAAI,CAAC;IACzB,UAAU,IAAI,IAAI,CAAC;IACnB,eAAe,IAAI,IAAI,CAAC;IACxB,YAAY,IAAI,IAAI,CAAC;IACrB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qBAAqB,IAAI,IAAI,CAAC;IAC9B,qBAAqB,IAAI,IAAI,CAAC;IAC9B,aAAa,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,UAAU,IAAI,IAAI,CAAC;IACnB,YAAY,IAAI,IAAI,CAAC;IACrB,+EAA+E;IAC/E,SAAS,IAAI,IAAI,CAAC;IAClB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACtD;AAqCD,wBAAgB,uBAAuB,CACtC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACpB,MAAM,CAER;AA0GD,wBAAgB,wBAAwB,CACvC,YAAY,EAAE,MAAM,EACpB,sBAAsB,EAAE,MAAM,GAC5B,kBAAkB,CAYpB;AAED,wBAAgB,yBAAyB,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,qBAAqB,GAC7B,IAAI,CAoBN;AA0ED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB,GAAG,wBAAwB,CAU3B"}