@nubl/maestro 0.0.1 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/README.md +55 -2
  2. package/dist/config.json.example +30 -0
  3. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
  4. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
  5. package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
  6. package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
  7. package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
  8. package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
  9. package/dist/maestro/adapters/pi/accept-groups.js +70 -0
  10. package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
  11. package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
  12. package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
  13. package/dist/maestro/adapters/pi/accept-runner.js +161 -0
  14. package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
  15. package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
  16. package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
  17. package/dist/maestro/adapters/pi/activity-file.js +454 -0
  18. package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
  19. package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
  20. package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
  21. package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
  22. package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
  23. package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
  24. package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
  25. package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
  26. package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
  27. package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
  28. package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
  29. package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
  30. package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
  31. package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
  32. package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
  33. package/dist/maestro/adapters/pi/child/entry.js +3 -0
  34. package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
  35. package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
  36. package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
  37. package/dist/maestro/adapters/pi/child/protocol.js +510 -0
  38. package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
  39. package/dist/maestro/adapters/pi/completion.d.ts +45 -0
  40. package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
  41. package/dist/maestro/adapters/pi/completion.js +295 -0
  42. package/dist/maestro/adapters/pi/completion.js.map +1 -0
  43. package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
  44. package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
  45. package/dist/maestro/adapters/pi/launch-command.js +75 -0
  46. package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
  47. package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
  48. package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
  49. package/dist/maestro/adapters/pi/launch-operations.js +270 -0
  50. package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
  51. package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
  52. package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
  53. package/dist/maestro/adapters/pi/launch-resume.js +183 -0
  54. package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
  55. package/dist/maestro/adapters/pi/launch.d.ts +148 -0
  56. package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
  57. package/dist/maestro/adapters/pi/launch.js +655 -0
  58. package/dist/maestro/adapters/pi/launch.js.map +1 -0
  59. package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
  60. package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
  61. package/dist/maestro/adapters/pi/model-registry.js +29 -0
  62. package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
  63. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
  64. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
  65. package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
  66. package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
  67. package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
  68. package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
  69. package/dist/maestro/adapters/pi/process-identity.js +248 -0
  70. package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
  71. package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
  72. package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
  73. package/dist/maestro/adapters/pi/process-tree.js +69 -0
  74. package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
  75. package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
  76. package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
  77. package/dist/maestro/adapters/pi/script-shell.js +43 -0
  78. package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
  79. package/dist/maestro/adapters/pi/session.d.ts +207 -0
  80. package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
  81. package/dist/maestro/adapters/pi/session.js +714 -0
  82. package/dist/maestro/adapters/pi/session.js.map +1 -0
  83. package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
  84. package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
  85. package/dist/maestro/adapters/pi/task-model-init.js +47 -0
  86. package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
  87. package/dist/maestro/core/accept.d.ts +150 -0
  88. package/dist/maestro/core/accept.d.ts.map +1 -0
  89. package/dist/maestro/core/accept.js +243 -0
  90. package/dist/maestro/core/accept.js.map +1 -0
  91. package/dist/maestro/core/activity.d.ts +4 -0
  92. package/dist/maestro/core/activity.d.ts.map +1 -0
  93. package/dist/maestro/core/activity.js +18 -0
  94. package/dist/maestro/core/activity.js.map +1 -0
  95. package/dist/maestro/core/child-busy.d.ts +14 -0
  96. package/dist/maestro/core/child-busy.d.ts.map +1 -0
  97. package/dist/maestro/core/child-busy.js +14 -0
  98. package/dist/maestro/core/child-busy.js.map +1 -0
  99. package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
  100. package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
  101. package/dist/maestro/core/config/guidelines-config.js +60 -0
  102. package/dist/maestro/core/config/guidelines-config.js.map +1 -0
  103. package/dist/maestro/core/config/herdr-config.d.ts +13 -0
  104. package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
  105. package/dist/maestro/core/config/herdr-config.js +65 -0
  106. package/dist/maestro/core/config/herdr-config.js.map +1 -0
  107. package/dist/maestro/core/config/model-config.d.ts +92 -0
  108. package/dist/maestro/core/config/model-config.d.ts.map +1 -0
  109. package/dist/maestro/core/config/model-config.js +522 -0
  110. package/dist/maestro/core/config/model-config.js.map +1 -0
  111. package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
  112. package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
  113. package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
  114. package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
  115. package/dist/maestro/core/config/pane-config.d.ts +15 -0
  116. package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
  117. package/dist/maestro/core/config/pane-config.js +101 -0
  118. package/dist/maestro/core/config/pane-config.js.map +1 -0
  119. package/dist/maestro/core/config/persistent-config.d.ts +7 -0
  120. package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
  121. package/dist/maestro/core/config/persistent-config.js +72 -0
  122. package/dist/maestro/core/config/persistent-config.js.map +1 -0
  123. package/dist/maestro/core/config/role-config.d.ts +7 -0
  124. package/dist/maestro/core/config/role-config.d.ts.map +1 -0
  125. package/dist/maestro/core/config/role-config.js +74 -0
  126. package/dist/maestro/core/config/role-config.js.map +1 -0
  127. package/dist/maestro/core/config/spawning-config.d.ts +7 -0
  128. package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
  129. package/dist/maestro/core/config/spawning-config.js +65 -0
  130. package/dist/maestro/core/config/spawning-config.js.map +1 -0
  131. package/dist/maestro/core/config/supervision-config.d.ts +7 -0
  132. package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
  133. package/dist/maestro/core/config/supervision-config.js +69 -0
  134. package/dist/maestro/core/config/supervision-config.js.map +1 -0
  135. package/dist/maestro/core/config/task-model-init.d.ts +118 -0
  136. package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
  137. package/dist/maestro/core/config/task-model-init.js +168 -0
  138. package/dist/maestro/core/config/task-model-init.js.map +1 -0
  139. package/dist/maestro/core/config/task-model-types.d.ts +36 -0
  140. package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
  141. package/dist/maestro/core/config/task-model-types.js +17 -0
  142. package/dist/maestro/core/config/task-model-types.js.map +1 -0
  143. package/dist/maestro/core/config/type-guards.d.ts +22 -0
  144. package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
  145. package/dist/maestro/core/config/type-guards.js +31 -0
  146. package/dist/maestro/core/config/type-guards.js.map +1 -0
  147. package/dist/maestro/core/deadline.d.ts +11 -0
  148. package/dist/maestro/core/deadline.d.ts.map +1 -0
  149. package/dist/maestro/core/deadline.js +30 -0
  150. package/dist/maestro/core/deadline.js.map +1 -0
  151. package/dist/maestro/core/declared-skills.d.ts +16 -0
  152. package/dist/maestro/core/declared-skills.d.ts.map +1 -0
  153. package/dist/maestro/core/declared-skills.js +52 -0
  154. package/dist/maestro/core/declared-skills.js.map +1 -0
  155. package/dist/maestro/core/delegation-depth.d.ts +38 -0
  156. package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
  157. package/dist/maestro/core/delegation-depth.js +59 -0
  158. package/dist/maestro/core/delegation-depth.js.map +1 -0
  159. package/dist/maestro/core/git-environment.d.ts +3 -0
  160. package/dist/maestro/core/git-environment.d.ts.map +1 -0
  161. package/dist/maestro/core/git-environment.js +29 -0
  162. package/dist/maestro/core/git-environment.js.map +1 -0
  163. package/dist/maestro/core/harness-adapter.d.ts +89 -0
  164. package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
  165. package/dist/maestro/core/harness-adapter.js +2 -0
  166. package/dist/maestro/core/harness-adapter.js.map +1 -0
  167. package/dist/maestro/core/host-text.d.ts +49 -0
  168. package/dist/maestro/core/host-text.d.ts.map +1 -0
  169. package/dist/maestro/core/host-text.js +106 -0
  170. package/dist/maestro/core/host-text.js.map +1 -0
  171. package/dist/maestro/core/index.d.ts +4 -0
  172. package/dist/maestro/core/index.d.ts.map +1 -0
  173. package/dist/maestro/core/index.js +2 -0
  174. package/dist/maestro/core/index.js.map +1 -0
  175. package/dist/maestro/core/lifecycle.d.ts +16 -0
  176. package/dist/maestro/core/lifecycle.d.ts.map +1 -0
  177. package/dist/maestro/core/lifecycle.js +429 -0
  178. package/dist/maestro/core/lifecycle.js.map +1 -0
  179. package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
  180. package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
  181. package/dist/maestro/core/opened-primary-workspace.js +49 -0
  182. package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
  183. package/dist/maestro/core/platform-support.d.ts +15 -0
  184. package/dist/maestro/core/platform-support.d.ts.map +1 -0
  185. package/dist/maestro/core/platform-support.js +23 -0
  186. package/dist/maestro/core/platform-support.js.map +1 -0
  187. package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
  188. package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
  189. package/dist/maestro/core/realpath-without-opening.js +45 -0
  190. package/dist/maestro/core/realpath-without-opening.js.map +1 -0
  191. package/dist/maestro/core/roles/discovery.d.ts +64 -0
  192. package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
  193. package/dist/maestro/core/roles/discovery.js +422 -0
  194. package/dist/maestro/core/roles/discovery.js.map +1 -0
  195. package/dist/maestro/core/routing.d.ts +115 -0
  196. package/dist/maestro/core/routing.d.ts.map +1 -0
  197. package/dist/maestro/core/routing.js +449 -0
  198. package/dist/maestro/core/routing.js.map +1 -0
  199. package/dist/maestro/core/script-launch.d.ts +47 -0
  200. package/dist/maestro/core/script-launch.d.ts.map +1 -0
  201. package/dist/maestro/core/script-launch.js +102 -0
  202. package/dist/maestro/core/script-launch.js.map +1 -0
  203. package/dist/maestro/core/shell.d.ts +2 -0
  204. package/dist/maestro/core/shell.d.ts.map +1 -0
  205. package/dist/maestro/core/shell.js +4 -0
  206. package/dist/maestro/core/shell.js.map +1 -0
  207. package/dist/maestro/core/specialist-notice.d.ts +36 -0
  208. package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
  209. package/dist/maestro/core/specialist-notice.js +41 -0
  210. package/dist/maestro/core/specialist-notice.js.map +1 -0
  211. package/dist/maestro/core/status.d.ts +87 -0
  212. package/dist/maestro/core/status.d.ts.map +1 -0
  213. package/dist/maestro/core/status.js +369 -0
  214. package/dist/maestro/core/status.js.map +1 -0
  215. package/dist/maestro/core/supervision.d.ts +56 -0
  216. package/dist/maestro/core/supervision.d.ts.map +1 -0
  217. package/dist/maestro/core/supervision.js +249 -0
  218. package/dist/maestro/core/supervision.js.map +1 -0
  219. package/dist/maestro/core/surface-provider.d.ts +200 -0
  220. package/dist/maestro/core/surface-provider.d.ts.map +1 -0
  221. package/dist/maestro/core/surface-provider.js +71 -0
  222. package/dist/maestro/core/surface-provider.js.map +1 -0
  223. package/dist/maestro/core/types.d.ts +388 -0
  224. package/dist/maestro/core/types.d.ts.map +1 -0
  225. package/dist/maestro/core/types.js +2 -0
  226. package/dist/maestro/core/types.js.map +1 -0
  227. package/dist/maestro/core/undelivered-children.d.ts +27 -0
  228. package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
  229. package/dist/maestro/core/undelivered-children.js +31 -0
  230. package/dist/maestro/core/undelivered-children.js.map +1 -0
  231. package/dist/maestro/core/wake.d.ts +32 -0
  232. package/dist/maestro/core/wake.d.ts.map +1 -0
  233. package/dist/maestro/core/wake.js +125 -0
  234. package/dist/maestro/core/wake.js.map +1 -0
  235. package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
  236. package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
  237. package/dist/maestro/core/worktree-cleanup.js +278 -0
  238. package/dist/maestro/core/worktree-cleanup.js.map +1 -0
  239. package/dist/maestro/core/worktree.d.ts +50 -0
  240. package/dist/maestro/core/worktree.d.ts.map +1 -0
  241. package/dist/maestro/core/worktree.js +23 -0
  242. package/dist/maestro/core/worktree.js.map +1 -0
  243. package/dist/maestro/engine.d.ts +5 -0
  244. package/dist/maestro/engine.d.ts.map +1 -0
  245. package/dist/maestro/engine.js +5 -0
  246. package/dist/maestro/engine.js.map +1 -0
  247. package/dist/maestro/pi/child.d.ts +8 -0
  248. package/dist/maestro/pi/child.d.ts.map +1 -0
  249. package/dist/maestro/pi/child.js +8 -0
  250. package/dist/maestro/pi/child.js.map +1 -0
  251. package/dist/maestro/pi/extension.d.ts +10 -0
  252. package/dist/maestro/pi/extension.d.ts.map +1 -0
  253. package/dist/maestro/pi/extension.js +8 -0
  254. package/dist/maestro/pi/extension.js.map +1 -0
  255. package/dist/maestro/pi/subagents-index.d.ts +9 -0
  256. package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
  257. package/dist/maestro/pi/subagents-index.js +9 -0
  258. package/dist/maestro/pi/subagents-index.js.map +1 -0
  259. package/dist/maestro/pi.d.ts +9 -0
  260. package/dist/maestro/pi.d.ts.map +1 -0
  261. package/dist/maestro/pi.js +7 -0
  262. package/dist/maestro/pi.js.map +1 -0
  263. package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
  264. package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
  265. package/dist/maestro/runtime/accept-recheck.js +92 -0
  266. package/dist/maestro/runtime/accept-recheck.js.map +1 -0
  267. package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
  268. package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
  269. package/dist/maestro/runtime/delegated-marker.js +200 -0
  270. package/dist/maestro/runtime/delegated-marker.js.map +1 -0
  271. package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
  272. package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
  273. package/dist/maestro/runtime/host-surface-binding.js +2 -0
  274. package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
  275. package/dist/maestro/runtime/index.d.ts +10 -0
  276. package/dist/maestro/runtime/index.d.ts.map +1 -0
  277. package/dist/maestro/runtime/index.js +6 -0
  278. package/dist/maestro/runtime/index.js.map +1 -0
  279. package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
  280. package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
  281. package/dist/maestro/runtime/pi-persistent-io.js +64 -0
  282. package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
  283. package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
  284. package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
  285. package/dist/maestro/runtime/pi-run-session-types.js +2 -0
  286. package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
  287. package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
  288. package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
  289. package/dist/maestro/runtime/pi-run-session.js +809 -0
  290. package/dist/maestro/runtime/pi-run-session.js.map +1 -0
  291. package/dist/maestro/runtime/run-session.d.ts +129 -0
  292. package/dist/maestro/runtime/run-session.d.ts.map +1 -0
  293. package/dist/maestro/runtime/run-session.js +680 -0
  294. package/dist/maestro/runtime/run-session.js.map +1 -0
  295. package/dist/maestro/runtime/surface-retention.d.ts +3 -0
  296. package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
  297. package/dist/maestro/runtime/surface-retention.js +5 -0
  298. package/dist/maestro/runtime/surface-retention.js.map +1 -0
  299. package/dist/maestro/runtime/task-model-init.d.ts +34 -0
  300. package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
  301. package/dist/maestro/runtime/task-model-init.js +78 -0
  302. package/dist/maestro/runtime/task-model-init.js.map +1 -0
  303. package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
  304. package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
  305. package/dist/maestro/runtime/worktree-operations.js +633 -0
  306. package/dist/maestro/runtime/worktree-operations.js.map +1 -0
  307. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
  308. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
  309. package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
  310. package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
  311. package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
  312. package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
  313. package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
  314. package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
  315. package/dist/maestro/testing/index.d.ts +5 -0
  316. package/dist/maestro/testing/index.d.ts.map +1 -0
  317. package/dist/maestro/testing/index.js +5 -0
  318. package/dist/maestro/testing/index.js.map +1 -0
  319. package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
  320. package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
  321. package/dist/maestro/testing/surface-provider.conformance.js +167 -0
  322. package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
  323. package/dist/pi-extension/subagents/catalog.d.ts +70 -0
  324. package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
  325. package/dist/pi-extension/subagents/catalog.js +231 -0
  326. package/dist/pi-extension/subagents/catalog.js.map +1 -0
  327. package/dist/pi-extension/subagents/config-path.d.ts +6 -0
  328. package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
  329. package/dist/pi-extension/subagents/config-path.js +21 -0
  330. package/dist/pi-extension/subagents/config-path.js.map +1 -0
  331. package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
  332. package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
  333. package/dist/pi-extension/subagents/control-tools.js +150 -0
  334. package/dist/pi-extension/subagents/control-tools.js.map +1 -0
  335. package/dist/pi-extension/subagents/controls.d.ts +52 -0
  336. package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
  337. package/dist/pi-extension/subagents/controls.js +173 -0
  338. package/dist/pi-extension/subagents/controls.js.map +1 -0
  339. package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
  340. package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
  341. package/dist/pi-extension/subagents/deferred-tools.js +67 -0
  342. package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
  343. package/dist/pi-extension/subagents/delivery.d.ts +22 -0
  344. package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
  345. package/dist/pi-extension/subagents/delivery.js +365 -0
  346. package/dist/pi-extension/subagents/delivery.js.map +1 -0
  347. package/dist/pi-extension/subagents/extension.d.ts +100 -0
  348. package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
  349. package/dist/pi-extension/subagents/extension.js +367 -0
  350. package/dist/pi-extension/subagents/extension.js.map +1 -0
  351. package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
  352. package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
  353. package/dist/pi-extension/subagents/launch-tools.js +373 -0
  354. package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
  355. package/dist/pi-extension/subagents/launch.d.ts +86 -0
  356. package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
  357. package/dist/pi-extension/subagents/launch.js +133 -0
  358. package/dist/pi-extension/subagents/launch.js.map +1 -0
  359. package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
  360. package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
  361. package/dist/pi-extension/subagents/model-registry.js +52 -0
  362. package/dist/pi-extension/subagents/model-registry.js.map +1 -0
  363. package/dist/pi-extension/subagents/observation.d.ts +38 -0
  364. package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
  365. package/dist/pi-extension/subagents/observation.js +168 -0
  366. package/dist/pi-extension/subagents/observation.js.map +1 -0
  367. package/dist/pi-extension/subagents/persistent.d.ts +72 -0
  368. package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
  369. package/dist/pi-extension/subagents/persistent.js +322 -0
  370. package/dist/pi-extension/subagents/persistent.js.map +1 -0
  371. package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
  372. package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
  373. package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
  374. package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
  375. package/dist/pi-extension/subagents/presentation.d.ts +149 -0
  376. package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
  377. package/dist/pi-extension/subagents/presentation.js +419 -0
  378. package/dist/pi-extension/subagents/presentation.js.map +1 -0
  379. package/dist/pi-extension/subagents/state.d.ts +183 -0
  380. package/dist/pi-extension/subagents/state.d.ts.map +1 -0
  381. package/dist/pi-extension/subagents/state.js +92 -0
  382. package/dist/pi-extension/subagents/state.js.map +1 -0
  383. package/dist/pi-extension/subagents/task-models.d.ts +9 -0
  384. package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
  385. package/dist/pi-extension/subagents/task-models.js +293 -0
  386. package/dist/pi-extension/subagents/task-models.js.map +1 -0
  387. package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
  388. package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
  389. package/dist/pi-extension/subagents/tool-boundary.js +53 -0
  390. package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
  391. package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
  392. package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
  393. package/dist/pi-extension/subagents/worktree-tools.js +185 -0
  394. package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
  395. package/dist/provenance.json +5 -0
  396. package/package.json +540 -27
  397. package/index.d.ts +0 -1
  398. package/index.js +0 -2
@@ -0,0 +1,181 @@
1
+ import assert from "node:assert/strict";
2
+ import { describe as nodeDescribe, it as nodeIt } from "node:test";
3
+ const VALID_STATES = new Set([
4
+ "idle",
5
+ "working",
6
+ "blocked",
7
+ "done",
8
+ "unknown",
9
+ ]);
10
+ const WAIT_TIMEOUT_MS = 500;
11
+ export function registerHarnessAdapterConformance(runner, name, factory) {
12
+ runner.describe(`${name} HarnessAdapter conformance`, () => {
13
+ runner.it("spawn returns a handle whose harness equals adapter.name and startedAt is recent", async () => {
14
+ await usingFixture(factory, async ({ adapter, spawnOptions }) => {
15
+ const before = Date.now();
16
+ const handle = await adapter.spawn(spawnOptions());
17
+ const after = Date.now();
18
+ assert.equal(handle.harness, adapter.name);
19
+ assert.equal(handle.startedAt >= before, true);
20
+ assert.equal(handle.startedAt <= after, true);
21
+ assert.ok(handle.id.length > 0);
22
+ });
23
+ });
24
+ runner.it("getState never throws and returns one of the five states", async () => {
25
+ await usingFixture(factory, async ({ adapter, spawnOptions }) => {
26
+ const handle = await adapter.spawn(spawnOptions());
27
+ const state = await adapter.getState(handle);
28
+ assert.equal(VALID_STATES.has(state), true);
29
+ });
30
+ });
31
+ runner.it("awaitCompletion resolves done evidence", async () => {
32
+ await usingFixture(factory, async ({ adapter, spawnOptions, finish, waitTimeoutMs }) => {
33
+ const handle = await adapter.spawn(spawnOptions());
34
+ const wait = adapter.awaitCompletion(handle, new AbortController().signal);
35
+ await finish(handle, "done");
36
+ const evidence = await withTimeout(wait, waitTimeoutMs);
37
+ assert.equal(evidence.reason, "done");
38
+ assert.equal(evidence.exitCode, 0);
39
+ });
40
+ });
41
+ runner.it("awaitCompletion resolves ping evidence with name and message", async () => {
42
+ await usingFixture(factory, async ({ adapter, spawnOptions, finish, waitTimeoutMs }) => {
43
+ const handle = await adapter.spawn(spawnOptions());
44
+ const wait = adapter.awaitCompletion(handle, new AbortController().signal);
45
+ await finish(handle, "ping");
46
+ const evidence = await withTimeout(wait, waitTimeoutMs);
47
+ assert.equal(evidence.reason, "ping");
48
+ assert.equal(evidence.exitCode, 0);
49
+ assert.equal(evidence.ping?.name, handle.name);
50
+ assert.ok(evidence.ping?.message);
51
+ });
52
+ });
53
+ runner.it("awaitCompletion resolves error evidence with errorMessage", async () => {
54
+ await usingFixture(factory, async ({ adapter, spawnOptions, finish, waitTimeoutMs, errorMessagePattern, }) => {
55
+ const handle = await adapter.spawn(spawnOptions());
56
+ const wait = adapter.awaitCompletion(handle, new AbortController().signal);
57
+ await finish(handle, "error");
58
+ const evidence = await withTimeout(wait, waitTimeoutMs);
59
+ assert.equal(evidence.reason, "error");
60
+ assert.equal(evidence.exitCode, 1);
61
+ assert.match(evidence.errorMessage ?? "", errorMessagePattern ?? /error/i);
62
+ });
63
+ });
64
+ runner.it("awaitCompletion rejects when the signal aborts", async () => {
65
+ await usingFixture(factory, async ({ adapter, spawnOptions, waitTimeoutMs }) => {
66
+ const handle = await adapter.spawn(spawnOptions());
67
+ const controller = new AbortController();
68
+ const wait = adapter.awaitCompletion(handle, controller.signal);
69
+ setTimeout(() => controller.abort(), 50);
70
+ await assert.rejects(withTimeout(wait, waitTimeoutMs), /abort/i);
71
+ });
72
+ });
73
+ runner.it("interrupt leaves getState not done", async () => {
74
+ await usingFixture(factory, async ({ adapter, spawnOptions }) => {
75
+ const handle = await adapter.spawn(spawnOptions());
76
+ await adapter.interrupt(handle);
77
+ assert.notEqual(await adapter.getState(handle), "done");
78
+ });
79
+ });
80
+ runner.it("kill then getState returns done or unknown", async () => {
81
+ await usingFixture(factory, async ({ adapter, spawnOptions }) => {
82
+ const handle = await adapter.spawn(spawnOptions());
83
+ await adapter.kill(handle);
84
+ assert.match(await adapter.getState(handle), /^(done|unknown)$/);
85
+ });
86
+ });
87
+ runner.it("resume of a known session returns a new handle with the same sessionId", async () => {
88
+ await usingFixture(factory, async ({ adapter, spawnOptions, finish, waitTimeoutMs }) => {
89
+ const original = await adapter.spawn(spawnOptions());
90
+ await finish(original, "done");
91
+ await withTimeout(adapter.awaitCompletion(original, new AbortController().signal), waitTimeoutMs);
92
+ const resumed = await adapter.resume({
93
+ name: `${original.name}-resumed`,
94
+ sessionId: original.sessionId,
95
+ message: "continue",
96
+ });
97
+ assert.notEqual(resumed.id, original.id);
98
+ assert.equal(resumed.sessionId, original.sessionId);
99
+ assert.equal(resumed.name, `${original.name}-resumed`);
100
+ });
101
+ });
102
+ runner.it("late sidecar after pane absence resolves done when supported", async (t) => {
103
+ await usingFixture(factory, async (fixture) => {
104
+ if (!fixture.lateSidecar) {
105
+ t.skip("late sidecar after pane absence is implementation-specific and unsupported by this fixture");
106
+ return;
107
+ }
108
+ const handle = await fixture.adapter.spawn(fixture.spawnOptions());
109
+ const wait = fixture.adapter.awaitCompletion(handle, new AbortController().signal);
110
+ await fixture.lateSidecar(handle);
111
+ const evidence = await withTimeout(wait, fixture.waitTimeoutMs);
112
+ assert.equal(evidence.reason, "done");
113
+ assert.equal(evidence.exitCode, 0);
114
+ });
115
+ });
116
+ runner.it("resume honors the fixture's explicit managed-session policy", async () => {
117
+ await usingFixture(factory, async (fixture) => {
118
+ const baseOptions = fixture.spawnOptions();
119
+ const options = fixture.worktreeSpawnOptions
120
+ ? await fixture.worktreeSpawnOptions(baseOptions)
121
+ : withProvisionedWorktree(baseOptions);
122
+ const original = await fixture.adapter.spawn(options);
123
+ assert.ok(original.worktree, "original handle must own a worktree");
124
+ await fixture.finish(original, "done");
125
+ await withTimeout(fixture.adapter.awaitCompletion(original, new AbortController().signal), fixture.waitTimeoutMs);
126
+ const request = {
127
+ name: `${original.name}-resume-no-worktree`,
128
+ sessionId: original.sessionId,
129
+ };
130
+ if (fixture.managedSessionResume?.kind === "refused") {
131
+ await assert.rejects(fixture.adapter.resume(request), fixture.managedSessionResume.message);
132
+ return;
133
+ }
134
+ const resumed = await fixture.adapter.resume(request);
135
+ assert.equal(resumed.sessionId, original.sessionId);
136
+ assert.equal(resumed.worktree, undefined);
137
+ });
138
+ });
139
+ });
140
+ }
141
+ async function usingFixture(factory, test) {
142
+ const fixture = await factory();
143
+ try {
144
+ await test(fixture);
145
+ }
146
+ finally {
147
+ await fixture.dispose();
148
+ }
149
+ }
150
+ async function withTimeout(promise, timeoutMs = WAIT_TIMEOUT_MS) {
151
+ let timeout;
152
+ const timeoutPromise = new Promise((_, reject) => {
153
+ timeout = setTimeout(() => reject(new Error(`timed out after ${timeoutMs}ms`)), timeoutMs);
154
+ });
155
+ try {
156
+ return await Promise.race([promise, timeoutPromise]);
157
+ }
158
+ finally {
159
+ if (timeout)
160
+ clearTimeout(timeout);
161
+ }
162
+ }
163
+ function withProvisionedWorktree(options) {
164
+ const worktree = {
165
+ id: `${options.sessionId}-worktree-owner`,
166
+ owner: "maestro",
167
+ branch: "conformance-worktree",
168
+ baseRef: "HEAD",
169
+ baseSha: "0000000000000000000000000000000000000000",
170
+ createdAt: Date.now(),
171
+ path: `${options.cwd}/.fake-worktrees/conformance-worktree`,
172
+ state: "running",
173
+ manifestFile: `${options.cwd}/.fake-worktrees/conformance-worktree/.maestro.json`,
174
+ };
175
+ return {
176
+ ...options,
177
+ worktree,
178
+ worktreeRequest: { branch: worktree.branch, base: worktree.baseRef },
179
+ };
180
+ }
181
+ //# sourceMappingURL=harness-adapter.conformance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"harness-adapter.conformance.js","sourceRoot":"","sources":["../../../maestro/testing/harness-adapter.conformance.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from \"node:assert/strict\";\nimport { describe as nodeDescribe, it as nodeIt } from \"node:test\";\nimport type {\n\tHarnessAdapter,\n\tSpawnOptions,\n} from \"../../maestro/core/harness-adapter.ts\";\nimport type {\n\tAgentHandle,\n\tAgentState,\n\tWorktree,\n} from \"../../maestro/core/types.ts\";\n\ninterface TestRunner {\n\tdescribe: typeof nodeDescribe;\n\tit: typeof nodeIt;\n}\n\nexport interface HarnessAdapterFixture {\n\tadapter: HarnessAdapter;\n\t/** Fake fixtures retain the tight default; real process fixtures choose a bounded budget. */\n\twaitTimeoutMs?: number;\n\t/** Raw provider errors need not contain the literal word \"error\". */\n\terrorMessagePattern?: RegExp;\n\t/** Explicit saved-session policy expectation, not an arbitrary rejection allowance. */\n\tmanagedSessionResume?:\n\t\t| { kind: \"refused\"; message: RegExp }\n\t\t| { kind: \"detached\" };\n\tspawnOptions(): SpawnOptions;\n\tfinish(handle: AgentHandle, kind: \"done\" | \"ping\" | \"error\"): Promise<void>;\n\t/** Optional implementation-specific simulation of delayed sidecar evidence after pane absence. */\n\tlateSidecar?(handle: AgentHandle): Promise<void>;\n\t/** Optional hook for implementations that need provider-specific worktree setup before spawn. */\n\tworktreeSpawnOptions?(base: SpawnOptions): Promise<SpawnOptions>;\n\tdispose(): Promise<void>;\n}\n\nconst VALID_STATES = new Set<AgentState>([\n\t\"idle\",\n\t\"working\",\n\t\"blocked\",\n\t\"done\",\n\t\"unknown\",\n]);\nconst WAIT_TIMEOUT_MS = 500;\n\nexport function registerHarnessAdapterConformance(\n\trunner: TestRunner,\n\tname: string,\n\tfactory: () => Promise<HarnessAdapterFixture>,\n): void {\n\trunner.describe(`${name} HarnessAdapter conformance`, () => {\n\t\trunner.it(\n\t\t\t\"spawn returns a handle whose harness equals adapter.name and startedAt is recent\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ adapter, spawnOptions }) => {\n\t\t\t\t\tconst before = Date.now();\n\t\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\t\tconst after = Date.now();\n\n\t\t\t\t\tassert.equal(handle.harness, adapter.name);\n\t\t\t\t\tassert.equal(handle.startedAt >= before, true);\n\t\t\t\t\tassert.equal(handle.startedAt <= after, true);\n\t\t\t\t\tassert.ok(handle.id.length > 0);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"getState never throws and returns one of the five states\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ adapter, spawnOptions }) => {\n\t\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\t\tconst state = await adapter.getState(handle);\n\t\t\t\t\tassert.equal(VALID_STATES.has(state), true);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\"awaitCompletion resolves done evidence\", async () => {\n\t\t\tawait usingFixture(\n\t\t\t\tfactory,\n\t\t\t\tasync ({ adapter, spawnOptions, finish, waitTimeoutMs }) => {\n\t\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\t\tconst wait = adapter.awaitCompletion(\n\t\t\t\t\t\thandle,\n\t\t\t\t\t\tnew AbortController().signal,\n\t\t\t\t\t);\n\t\t\t\t\tawait finish(handle, \"done\");\n\t\t\t\t\tconst evidence = await withTimeout(wait, waitTimeoutMs);\n\n\t\t\t\t\tassert.equal(evidence.reason, \"done\");\n\t\t\t\t\tassert.equal(evidence.exitCode, 0);\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\n\t\trunner.it(\n\t\t\t\"awaitCompletion resolves ping evidence with name and message\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(\n\t\t\t\t\tfactory,\n\t\t\t\t\tasync ({ adapter, spawnOptions, finish, waitTimeoutMs }) => {\n\t\t\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\t\t\tconst wait = adapter.awaitCompletion(\n\t\t\t\t\t\t\thandle,\n\t\t\t\t\t\t\tnew AbortController().signal,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tawait finish(handle, \"ping\");\n\t\t\t\t\t\tconst evidence = await withTimeout(wait, waitTimeoutMs);\n\n\t\t\t\t\t\tassert.equal(evidence.reason, \"ping\");\n\t\t\t\t\t\tassert.equal(evidence.exitCode, 0);\n\t\t\t\t\t\tassert.equal(evidence.ping?.name, handle.name);\n\t\t\t\t\t\tassert.ok(evidence.ping?.message);\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"awaitCompletion resolves error evidence with errorMessage\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(\n\t\t\t\t\tfactory,\n\t\t\t\t\tasync ({\n\t\t\t\t\t\tadapter,\n\t\t\t\t\t\tspawnOptions,\n\t\t\t\t\t\tfinish,\n\t\t\t\t\t\twaitTimeoutMs,\n\t\t\t\t\t\terrorMessagePattern,\n\t\t\t\t\t}) => {\n\t\t\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\t\t\tconst wait = adapter.awaitCompletion(\n\t\t\t\t\t\t\thandle,\n\t\t\t\t\t\t\tnew AbortController().signal,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tawait finish(handle, \"error\");\n\t\t\t\t\t\tconst evidence = await withTimeout(wait, waitTimeoutMs);\n\n\t\t\t\t\t\tassert.equal(evidence.reason, \"error\");\n\t\t\t\t\t\tassert.equal(evidence.exitCode, 1);\n\t\t\t\t\t\tassert.match(\n\t\t\t\t\t\t\tevidence.errorMessage ?? \"\",\n\t\t\t\t\t\t\terrorMessagePattern ?? /error/i,\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\"awaitCompletion rejects when the signal aborts\", async () => {\n\t\t\tawait usingFixture(\n\t\t\t\tfactory,\n\t\t\t\tasync ({ adapter, spawnOptions, waitTimeoutMs }) => {\n\t\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\t\tconst controller = new AbortController();\n\t\t\t\t\tconst wait = adapter.awaitCompletion(handle, controller.signal);\n\t\t\t\t\tsetTimeout(() => controller.abort(), 50);\n\t\t\t\t\tawait assert.rejects(withTimeout(wait, waitTimeoutMs), /abort/i);\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\n\t\trunner.it(\"interrupt leaves getState not done\", async () => {\n\t\t\tawait usingFixture(factory, async ({ adapter, spawnOptions }) => {\n\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\tawait adapter.interrupt(handle);\n\t\t\t\tassert.notEqual(await adapter.getState(handle), \"done\");\n\t\t\t});\n\t\t});\n\n\t\trunner.it(\"kill then getState returns done or unknown\", async () => {\n\t\t\tawait usingFixture(factory, async ({ adapter, spawnOptions }) => {\n\t\t\t\tconst handle = await adapter.spawn(spawnOptions());\n\t\t\t\tawait adapter.kill(handle);\n\t\t\t\tassert.match(await adapter.getState(handle), /^(done|unknown)$/);\n\t\t\t});\n\t\t});\n\n\t\trunner.it(\n\t\t\t\"resume of a known session returns a new handle with the same sessionId\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(\n\t\t\t\t\tfactory,\n\t\t\t\t\tasync ({ adapter, spawnOptions, finish, waitTimeoutMs }) => {\n\t\t\t\t\t\tconst original = await adapter.spawn(spawnOptions());\n\t\t\t\t\t\tawait finish(original, \"done\");\n\t\t\t\t\t\tawait withTimeout(\n\t\t\t\t\t\t\tadapter.awaitCompletion(original, new AbortController().signal),\n\t\t\t\t\t\t\twaitTimeoutMs,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst resumed = await adapter.resume({\n\t\t\t\t\t\t\tname: `${original.name}-resumed`,\n\t\t\t\t\t\t\tsessionId: original.sessionId,\n\t\t\t\t\t\t\tmessage: \"continue\",\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tassert.notEqual(resumed.id, original.id);\n\t\t\t\t\t\tassert.equal(resumed.sessionId, original.sessionId);\n\t\t\t\t\t\tassert.equal(resumed.name, `${original.name}-resumed`);\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"late sidecar after pane absence resolves done when supported\",\n\t\t\tasync (t) => {\n\t\t\t\tawait usingFixture(factory, async (fixture) => {\n\t\t\t\t\tif (!fixture.lateSidecar) {\n\t\t\t\t\t\tt.skip(\n\t\t\t\t\t\t\t\"late sidecar after pane absence is implementation-specific and unsupported by this fixture\",\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst handle = await fixture.adapter.spawn(fixture.spawnOptions());\n\t\t\t\t\tconst wait = fixture.adapter.awaitCompletion(\n\t\t\t\t\t\thandle,\n\t\t\t\t\t\tnew AbortController().signal,\n\t\t\t\t\t);\n\t\t\t\t\tawait fixture.lateSidecar(handle);\n\t\t\t\t\tconst evidence = await withTimeout(wait, fixture.waitTimeoutMs);\n\n\t\t\t\t\tassert.equal(evidence.reason, \"done\");\n\t\t\t\t\tassert.equal(evidence.exitCode, 0);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"resume honors the fixture's explicit managed-session policy\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async (fixture) => {\n\t\t\t\t\tconst baseOptions = fixture.spawnOptions();\n\t\t\t\t\tconst options = fixture.worktreeSpawnOptions\n\t\t\t\t\t\t? await fixture.worktreeSpawnOptions(baseOptions)\n\t\t\t\t\t\t: withProvisionedWorktree(baseOptions);\n\t\t\t\t\tconst original = await fixture.adapter.spawn(options);\n\t\t\t\t\tassert.ok(original.worktree, \"original handle must own a worktree\");\n\n\t\t\t\t\tawait fixture.finish(original, \"done\");\n\t\t\t\t\tawait withTimeout(\n\t\t\t\t\t\tfixture.adapter.awaitCompletion(\n\t\t\t\t\t\t\toriginal,\n\t\t\t\t\t\t\tnew AbortController().signal,\n\t\t\t\t\t\t),\n\t\t\t\t\t\tfixture.waitTimeoutMs,\n\t\t\t\t\t);\n\t\t\t\t\tconst request = {\n\t\t\t\t\t\tname: `${original.name}-resume-no-worktree`,\n\t\t\t\t\t\tsessionId: original.sessionId,\n\t\t\t\t\t};\n\t\t\t\t\tif (fixture.managedSessionResume?.kind === \"refused\") {\n\t\t\t\t\t\tawait assert.rejects(\n\t\t\t\t\t\t\tfixture.adapter.resume(request),\n\t\t\t\t\t\t\tfixture.managedSessionResume.message,\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst resumed = await fixture.adapter.resume(request);\n\n\t\t\t\t\tassert.equal(resumed.sessionId, original.sessionId);\n\t\t\t\t\tassert.equal(resumed.worktree, undefined);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\t});\n}\n\nasync function usingFixture(\n\tfactory: () => Promise<HarnessAdapterFixture>,\n\ttest: (fixture: HarnessAdapterFixture) => Promise<void>,\n) {\n\tconst fixture = await factory();\n\ttry {\n\t\tawait test(fixture);\n\t} finally {\n\t\tawait fixture.dispose();\n\t}\n}\n\nasync function withTimeout<T>(\n\tpromise: Promise<T>,\n\ttimeoutMs = WAIT_TIMEOUT_MS,\n): Promise<T> {\n\tlet timeout: NodeJS.Timeout | undefined;\n\tconst timeoutPromise = new Promise<never>((_, reject) => {\n\t\ttimeout = setTimeout(\n\t\t\t() => reject(new Error(`timed out after ${timeoutMs}ms`)),\n\t\t\ttimeoutMs,\n\t\t);\n\t});\n\ttry {\n\t\treturn await Promise.race([promise, timeoutPromise]);\n\t} finally {\n\t\tif (timeout) clearTimeout(timeout);\n\t}\n}\n\nfunction withProvisionedWorktree(options: SpawnOptions): SpawnOptions {\n\tconst worktree: Worktree = {\n\t\tid: `${options.sessionId}-worktree-owner`,\n\t\towner: \"maestro\",\n\t\tbranch: \"conformance-worktree\",\n\t\tbaseRef: \"HEAD\",\n\t\tbaseSha: \"0000000000000000000000000000000000000000\",\n\t\tcreatedAt: Date.now(),\n\t\tpath: `${options.cwd}/.fake-worktrees/conformance-worktree`,\n\t\tstate: \"running\",\n\t\tmanifestFile: `${options.cwd}/.fake-worktrees/conformance-worktree/.maestro.json`,\n\t};\n\treturn {\n\t\t...options,\n\t\tworktree,\n\t\tworktreeRequest: { branch: worktree.branch, base: worktree.baseRef },\n\t};\n}\n"]}
@@ -0,0 +1,5 @@
1
+ export { FakeHarnessAdapter } from "../adapters/fake/fake-harness-adapter.ts";
2
+ export { FakeSurfaceProvider } from "../surfaces/fake/fake-surface-provider.ts";
3
+ export * from "./harness-adapter.conformance.ts";
4
+ export * from "./surface-provider.conformance.ts";
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../maestro/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC"}
@@ -0,0 +1,5 @@
1
+ export { FakeHarnessAdapter } from "../adapters/fake/fake-harness-adapter.js";
2
+ export { FakeSurfaceProvider } from "../surfaces/fake/fake-surface-provider.js";
3
+ export * from "./harness-adapter.conformance.js";
4
+ export * from "./surface-provider.conformance.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../maestro/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC","sourcesContent":["export { FakeHarnessAdapter } from \"../adapters/fake/fake-harness-adapter.ts\";\nexport { FakeSurfaceProvider } from \"../surfaces/fake/fake-surface-provider.ts\";\nexport * from \"./harness-adapter.conformance.ts\";\nexport * from \"./surface-provider.conformance.ts\";\n"]}
@@ -0,0 +1,20 @@
1
+ import { describe as nodeDescribe, it as nodeIt } from "node:test";
2
+ import type { SurfaceProvider } from "../../maestro/core/surface-provider.ts";
3
+ interface TestRunner {
4
+ describe: typeof nodeDescribe;
5
+ it: typeof nodeIt;
6
+ }
7
+ interface SurfaceProviderFixture {
8
+ provider: SurfaceProvider;
9
+ cwd: string;
10
+ /**
11
+ * Maximum grouped surfaces per provider group. The fixture must provide an
12
+ * empty, isolated grouping space so conformance can count only its surfaces.
13
+ */
14
+ groupingCap?: number;
15
+ dispose(): Promise<void>;
16
+ }
17
+ export declare function registerSurfaceProviderConformance(runner: TestRunner, name: string, factory: () => Promise<SurfaceProviderFixture>): void;
18
+ export declare function hasStandaloneScreenLine(screen: string, needle: string): boolean;
19
+ export {};
20
+ //# sourceMappingURL=surface-provider.conformance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"surface-provider.conformance.d.ts","sourceRoot":"","sources":["../../../maestro/testing/surface-provider.conformance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE9E,UAAU,UAAU;IACnB,QAAQ,EAAE,OAAO,YAAY,CAAC;IAC9B,EAAE,EAAE,OAAO,MAAM,CAAC;CAClB;AAED,UAAU,sBAAsB;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAKD,wBAAgB,kCAAkC,CACjD,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,GAC5C,IAAI,CA8LN;AA8BD,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAET"}
@@ -0,0 +1,167 @@
1
+ import assert from "node:assert/strict";
2
+ import { describe as nodeDescribe, it as nodeIt } from "node:test";
3
+ const DEFAULT_GROUPING_CAP = 4;
4
+ const WAIT_INTERVAL_MS = 50;
5
+ export function registerSurfaceProviderConformance(runner, name, factory) {
6
+ runner.describe(`${name} SurfaceProvider conformance`, () => {
7
+ runner.it("isAvailable returns a boolean and never throws", async () => {
8
+ await usingFixture(factory, async ({ provider }) => {
9
+ const available = provider.isAvailable();
10
+ assert.equal(available === true || available === false, true);
11
+ });
12
+ });
13
+ runner.it("createSurface returns an id listed by listSurfaces with name and cwd", async () => {
14
+ await usingFixture(factory, async ({ provider, cwd }) => {
15
+ const surfaceId = await provider.createSurface({
16
+ name: "conformance-create",
17
+ cwd,
18
+ });
19
+ const surfaces = await provider.listSurfaces();
20
+ assert.ok(surfaceId.length > 0);
21
+ const surface = surfaces.find((entry) => entry.id === surfaceId);
22
+ assert.ok(surface);
23
+ assert.equal(surface.name, "conformance-create");
24
+ assert.equal(surface.cwd, cwd);
25
+ });
26
+ });
27
+ runner.it("runCommand then readScreen shows the command output", async () => {
28
+ await usingFixture(factory, async ({ provider, cwd }) => {
29
+ const outputMarker = "conformance-marker";
30
+ const surfaceId = await provider.createSurface({
31
+ name: "conformance-run",
32
+ cwd,
33
+ });
34
+ await provider.waitForShellReady(surfaceId, { timeoutMs: 5_000 });
35
+ await provider.runCommand(surfaceId, `echo ${outputMarker}`);
36
+ const screen = await readScreenUntilStandaloneLine(provider, surfaceId, outputMarker, 5_000);
37
+ assert.equal(hasStandaloneScreenLine(screen, outputMarker), true);
38
+ });
39
+ });
40
+ runner.it("inspectSurface returns a PaneInspection for a live surface", async () => {
41
+ await usingFixture(factory, async ({ provider, cwd }) => {
42
+ const surfaceId = await provider.createSurface({
43
+ name: "conformance-inspect",
44
+ cwd,
45
+ });
46
+ const inspection = await provider.inspectSurface(surfaceId);
47
+ assert.equal(inspection.kind, "present");
48
+ assert.equal(Number.isFinite(inspection.observedAt), true);
49
+ });
50
+ });
51
+ runner.it("closeSurface then waitForSurfaceAbsence resolves", async () => {
52
+ await usingFixture(factory, async ({ provider, cwd }) => {
53
+ const surfaceId = await provider.createSurface({
54
+ name: "conformance-close",
55
+ cwd,
56
+ });
57
+ await assert.rejects(() => provider.waitForSurfaceAbsence(surfaceId, { timeoutMs: 0 }));
58
+ await provider.closeSurface(surfaceId);
59
+ await provider.waitForSurfaceAbsence(surfaceId, { timeoutMs: 5_000 });
60
+ const surfaces = await provider.listSurfaces();
61
+ assert.equal(surfaces.some((surface) => surface.id === surfaceId), false);
62
+ });
63
+ });
64
+ runner.it("grouped placement overflows to a new tab at the cap", async () => {
65
+ await usingFixture(factory, async (fixture) => {
66
+ const { provider, cwd } = fixture;
67
+ const groupingCap = fixture.groupingCap ?? DEFAULT_GROUPING_CAP;
68
+ const surfaceIds = [];
69
+ for (let index = 0; index < groupingCap + 1; index += 1) {
70
+ surfaceIds.push(await provider.createSurface({
71
+ name: `conformance-grouped-${index}`,
72
+ cwd,
73
+ placement: { kind: "grouped" },
74
+ }));
75
+ }
76
+ const surfaces = await provider.listSurfaces();
77
+ const createdSurfaces = surfaceIds.map((surfaceId) => surfaces.find((surface) => surface.id === surfaceId));
78
+ assert.equal(createdSurfaces.every(Boolean), true);
79
+ const groups = createdSurfaces.map((surface) => surface?.group);
80
+ assert.equal(groups.every((group) => Boolean(group)), true);
81
+ const groupCounts = countGroups(groups);
82
+ assert.equal(groupCounts.size, 2);
83
+ assert.equal(Array.from(groupCounts.values()).every((count) => count <= groupingCap), true);
84
+ });
85
+ });
86
+ runner.it("setupHint returns a non-empty string", async () => {
87
+ await usingFixture(factory, async ({ provider }) => {
88
+ assert.ok(provider.setupHint().trim().length > 0);
89
+ });
90
+ });
91
+ runner.it("attachSurface returns a handle with sendKeys and close", async () => {
92
+ await usingFixture(factory, async ({ provider, cwd }) => {
93
+ const surfaceId = await provider.createSurface({
94
+ name: "conformance-attach",
95
+ cwd,
96
+ });
97
+ const handle = provider.attachSurface(surfaceId);
98
+ assert.equal(handle.id, surfaceId);
99
+ assert.ok(handle.sendKeys);
100
+ assert.ok(handle.close);
101
+ await handle.sendKeys("Escape");
102
+ await handle.close();
103
+ });
104
+ });
105
+ runner.it("createWorktreeSurface registers neutral worktree inventory and removeWorktreeSurface removes it", async () => {
106
+ await usingFixture(factory, async ({ provider, cwd }) => {
107
+ const worktree = await provider.createWorktreeSurface({
108
+ name: "conformance-worktree",
109
+ cwd,
110
+ branch: "conformance-branch",
111
+ base: "HEAD",
112
+ });
113
+ assert.equal(worktree.branch, "conformance-branch");
114
+ assert.equal(worktree.path.length > 0, true);
115
+ assert.equal(worktree.surfaceId.length > 0, true);
116
+ const worktreeSurface = (await provider.listSurfaces()).find((surface) => surface.id === worktree.surfaceId);
117
+ assert.ok(worktreeSurface);
118
+ assert.equal(worktreeSurface.workspaceId, worktree.workspaceId);
119
+ let worktrees = await provider.listWorktreeSurfaces({ cwd });
120
+ const listed = worktrees.find((entry) => entry.workspaceId === worktree.workspaceId);
121
+ assert.ok(listed);
122
+ assert.equal(listed.path, worktree.path);
123
+ assert.equal(listed.branch, worktree.branch);
124
+ assert.equal(listed.workspaceId, worktree.workspaceId);
125
+ assert.equal(listed.isLinkedWorktree, true);
126
+ assert.equal(Object.hasOwn(listed, "surfaceId"), false);
127
+ await provider.removeWorktreeSurface(worktree.workspaceId);
128
+ worktrees = await provider.listWorktreeSurfaces({ cwd });
129
+ assert.equal(worktrees.some((entry) => entry.workspaceId === worktree.workspaceId), false);
130
+ const surfaces = await provider.listSurfaces();
131
+ assert.equal(surfaces.some((surface) => surface.id === worktree.surfaceId), false);
132
+ });
133
+ });
134
+ });
135
+ }
136
+ async function usingFixture(factory, test) {
137
+ const fixture = await factory();
138
+ try {
139
+ await test(fixture);
140
+ }
141
+ finally {
142
+ await fixture.dispose();
143
+ }
144
+ }
145
+ async function readScreenUntilStandaloneLine(provider, surfaceId, needle, timeoutMs) {
146
+ const deadline = Date.now() + timeoutMs;
147
+ let screen = "";
148
+ do {
149
+ screen = await provider.readScreen(surfaceId);
150
+ if (hasStandaloneScreenLine(screen, needle))
151
+ return screen;
152
+ await new Promise((resolve) => setTimeout(resolve, WAIT_INTERVAL_MS));
153
+ } while (Date.now() < deadline);
154
+ return screen;
155
+ }
156
+ export function hasStandaloneScreenLine(screen, needle) {
157
+ return screen.split(/\r?\n/).some((line) => line.trim() === needle);
158
+ }
159
+ function countGroups(groups) {
160
+ const counts = new Map();
161
+ for (const group of groups) {
162
+ assert.ok(group);
163
+ counts.set(group, (counts.get(group) ?? 0) + 1);
164
+ }
165
+ return counts;
166
+ }
167
+ //# sourceMappingURL=surface-provider.conformance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"surface-provider.conformance.js","sourceRoot":"","sources":["../../../maestro/testing/surface-provider.conformance.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from \"node:assert/strict\";\nimport { describe as nodeDescribe, it as nodeIt } from \"node:test\";\nimport type { SurfaceProvider } from \"../../maestro/core/surface-provider.ts\";\n\ninterface TestRunner {\n\tdescribe: typeof nodeDescribe;\n\tit: typeof nodeIt;\n}\n\ninterface SurfaceProviderFixture {\n\tprovider: SurfaceProvider;\n\tcwd: string;\n\t/**\n\t * Maximum grouped surfaces per provider group. The fixture must provide an\n\t * empty, isolated grouping space so conformance can count only its surfaces.\n\t */\n\tgroupingCap?: number;\n\tdispose(): Promise<void>;\n}\n\nconst DEFAULT_GROUPING_CAP = 4;\nconst WAIT_INTERVAL_MS = 50;\n\nexport function registerSurfaceProviderConformance(\n\trunner: TestRunner,\n\tname: string,\n\tfactory: () => Promise<SurfaceProviderFixture>,\n): void {\n\trunner.describe(`${name} SurfaceProvider conformance`, () => {\n\t\trunner.it(\"isAvailable returns a boolean and never throws\", async () => {\n\t\t\tawait usingFixture(factory, async ({ provider }) => {\n\t\t\t\tconst available = provider.isAvailable();\n\t\t\t\tassert.equal(available === true || available === false, true);\n\t\t\t});\n\t\t});\n\n\t\trunner.it(\n\t\t\t\"createSurface returns an id listed by listSurfaces with name and cwd\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ provider, cwd }) => {\n\t\t\t\t\tconst surfaceId = await provider.createSurface({\n\t\t\t\t\t\tname: \"conformance-create\",\n\t\t\t\t\t\tcwd,\n\t\t\t\t\t});\n\t\t\t\t\tconst surfaces = await provider.listSurfaces();\n\t\t\t\t\tassert.ok(surfaceId.length > 0);\n\t\t\t\t\tconst surface = surfaces.find((entry) => entry.id === surfaceId);\n\t\t\t\t\tassert.ok(surface);\n\t\t\t\t\tassert.equal(surface.name, \"conformance-create\");\n\t\t\t\t\tassert.equal(surface.cwd, cwd);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"runCommand then readScreen shows the command output\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ provider, cwd }) => {\n\t\t\t\t\tconst outputMarker = \"conformance-marker\";\n\t\t\t\t\tconst surfaceId = await provider.createSurface({\n\t\t\t\t\t\tname: \"conformance-run\",\n\t\t\t\t\t\tcwd,\n\t\t\t\t\t});\n\t\t\t\t\tawait provider.waitForShellReady(surfaceId, { timeoutMs: 5_000 });\n\t\t\t\t\tawait provider.runCommand(surfaceId, `echo ${outputMarker}`);\n\t\t\t\t\tconst screen = await readScreenUntilStandaloneLine(\n\t\t\t\t\t\tprovider,\n\t\t\t\t\t\tsurfaceId,\n\t\t\t\t\t\toutputMarker,\n\t\t\t\t\t\t5_000,\n\t\t\t\t\t);\n\t\t\t\t\tassert.equal(hasStandaloneScreenLine(screen, outputMarker), true);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"inspectSurface returns a PaneInspection for a live surface\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ provider, cwd }) => {\n\t\t\t\t\tconst surfaceId = await provider.createSurface({\n\t\t\t\t\t\tname: \"conformance-inspect\",\n\t\t\t\t\t\tcwd,\n\t\t\t\t\t});\n\t\t\t\t\tconst inspection = await provider.inspectSurface(surfaceId);\n\t\t\t\t\tassert.equal(inspection.kind, \"present\");\n\t\t\t\t\tassert.equal(Number.isFinite(inspection.observedAt), true);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\"closeSurface then waitForSurfaceAbsence resolves\", async () => {\n\t\t\tawait usingFixture(factory, async ({ provider, cwd }) => {\n\t\t\t\tconst surfaceId = await provider.createSurface({\n\t\t\t\t\tname: \"conformance-close\",\n\t\t\t\t\tcwd,\n\t\t\t\t});\n\t\t\t\tawait assert.rejects(() =>\n\t\t\t\t\tprovider.waitForSurfaceAbsence(surfaceId, { timeoutMs: 0 }),\n\t\t\t\t);\n\t\t\t\tawait provider.closeSurface(surfaceId);\n\t\t\t\tawait provider.waitForSurfaceAbsence(surfaceId, { timeoutMs: 5_000 });\n\t\t\t\tconst surfaces = await provider.listSurfaces();\n\t\t\t\tassert.equal(\n\t\t\t\t\tsurfaces.some((surface) => surface.id === surfaceId),\n\t\t\t\t\tfalse,\n\t\t\t\t);\n\t\t\t});\n\t\t});\n\n\t\trunner.it(\n\t\t\t\"grouped placement overflows to a new tab at the cap\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async (fixture) => {\n\t\t\t\t\tconst { provider, cwd } = fixture;\n\t\t\t\t\tconst groupingCap = fixture.groupingCap ?? DEFAULT_GROUPING_CAP;\n\t\t\t\t\tconst surfaceIds: string[] = [];\n\t\t\t\t\tfor (let index = 0; index < groupingCap + 1; index += 1) {\n\t\t\t\t\t\tsurfaceIds.push(\n\t\t\t\t\t\t\tawait provider.createSurface({\n\t\t\t\t\t\t\t\tname: `conformance-grouped-${index}`,\n\t\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\tplacement: { kind: \"grouped\" },\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst surfaces = await provider.listSurfaces();\n\t\t\t\t\tconst createdSurfaces = surfaceIds.map((surfaceId) =>\n\t\t\t\t\t\tsurfaces.find((surface) => surface.id === surfaceId),\n\t\t\t\t\t);\n\t\t\t\t\tassert.equal(createdSurfaces.every(Boolean), true);\n\t\t\t\t\tconst groups = createdSurfaces.map((surface) => surface?.group);\n\t\t\t\t\tassert.equal(\n\t\t\t\t\t\tgroups.every((group) => Boolean(group)),\n\t\t\t\t\t\ttrue,\n\t\t\t\t\t);\n\t\t\t\t\tconst groupCounts = countGroups(groups);\n\t\t\t\t\tassert.equal(groupCounts.size, 2);\n\t\t\t\t\tassert.equal(\n\t\t\t\t\t\tArray.from(groupCounts.values()).every(\n\t\t\t\t\t\t\t(count) => count <= groupingCap,\n\t\t\t\t\t\t),\n\t\t\t\t\t\ttrue,\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\"setupHint returns a non-empty string\", async () => {\n\t\t\tawait usingFixture(factory, async ({ provider }) => {\n\t\t\t\tassert.ok(provider.setupHint().trim().length > 0);\n\t\t\t});\n\t\t});\n\n\t\trunner.it(\n\t\t\t\"attachSurface returns a handle with sendKeys and close\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ provider, cwd }) => {\n\t\t\t\t\tconst surfaceId = await provider.createSurface({\n\t\t\t\t\t\tname: \"conformance-attach\",\n\t\t\t\t\t\tcwd,\n\t\t\t\t\t});\n\t\t\t\t\tconst handle = provider.attachSurface(surfaceId);\n\t\t\t\t\tassert.equal(handle.id, surfaceId);\n\t\t\t\t\tassert.ok(handle.sendKeys);\n\t\t\t\t\tassert.ok(handle.close);\n\t\t\t\t\tawait handle.sendKeys(\"Escape\");\n\t\t\t\t\tawait handle.close();\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\n\t\trunner.it(\n\t\t\t\"createWorktreeSurface registers neutral worktree inventory and removeWorktreeSurface removes it\",\n\t\t\tasync () => {\n\t\t\t\tawait usingFixture(factory, async ({ provider, cwd }) => {\n\t\t\t\t\tconst worktree = await provider.createWorktreeSurface({\n\t\t\t\t\t\tname: \"conformance-worktree\",\n\t\t\t\t\t\tcwd,\n\t\t\t\t\t\tbranch: \"conformance-branch\",\n\t\t\t\t\t\tbase: \"HEAD\",\n\t\t\t\t\t});\n\t\t\t\t\tassert.equal(worktree.branch, \"conformance-branch\");\n\t\t\t\t\tassert.equal(worktree.path.length > 0, true);\n\t\t\t\t\tassert.equal(worktree.surfaceId.length > 0, true);\n\t\t\t\t\tconst worktreeSurface = (await provider.listSurfaces()).find(\n\t\t\t\t\t\t(surface) => surface.id === worktree.surfaceId,\n\t\t\t\t\t);\n\t\t\t\t\tassert.ok(worktreeSurface);\n\t\t\t\t\tassert.equal(worktreeSurface.workspaceId, worktree.workspaceId);\n\t\t\t\t\tlet worktrees = await provider.listWorktreeSurfaces({ cwd });\n\t\t\t\t\tconst listed = worktrees.find(\n\t\t\t\t\t\t(entry) => entry.workspaceId === worktree.workspaceId,\n\t\t\t\t\t);\n\t\t\t\t\tassert.ok(listed);\n\t\t\t\t\tassert.equal(listed.path, worktree.path);\n\t\t\t\t\tassert.equal(listed.branch, worktree.branch);\n\t\t\t\t\tassert.equal(listed.workspaceId, worktree.workspaceId);\n\t\t\t\t\tassert.equal(listed.isLinkedWorktree, true);\n\t\t\t\t\tassert.equal(Object.hasOwn(listed, \"surfaceId\"), false);\n\t\t\t\t\tawait provider.removeWorktreeSurface(worktree.workspaceId);\n\t\t\t\t\tworktrees = await provider.listWorktreeSurfaces({ cwd });\n\t\t\t\t\tassert.equal(\n\t\t\t\t\t\tworktrees.some(\n\t\t\t\t\t\t\t(entry) => entry.workspaceId === worktree.workspaceId,\n\t\t\t\t\t\t),\n\t\t\t\t\t\tfalse,\n\t\t\t\t\t);\n\t\t\t\t\tconst surfaces = await provider.listSurfaces();\n\t\t\t\t\tassert.equal(\n\t\t\t\t\t\tsurfaces.some((surface) => surface.id === worktree.surfaceId),\n\t\t\t\t\t\tfalse,\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\t});\n}\n\nasync function usingFixture(\n\tfactory: () => Promise<SurfaceProviderFixture>,\n\ttest: (fixture: SurfaceProviderFixture) => Promise<void>,\n) {\n\tconst fixture = await factory();\n\ttry {\n\t\tawait test(fixture);\n\t} finally {\n\t\tawait fixture.dispose();\n\t}\n}\n\nasync function readScreenUntilStandaloneLine(\n\tprovider: SurfaceProvider,\n\tsurfaceId: string,\n\tneedle: string,\n\ttimeoutMs: number,\n) {\n\tconst deadline = Date.now() + timeoutMs;\n\tlet screen = \"\";\n\tdo {\n\t\tscreen = await provider.readScreen(surfaceId);\n\t\tif (hasStandaloneScreenLine(screen, needle)) return screen;\n\t\tawait new Promise((resolve) => setTimeout(resolve, WAIT_INTERVAL_MS));\n\t} while (Date.now() < deadline);\n\treturn screen;\n}\n\nexport function hasStandaloneScreenLine(\n\tscreen: string,\n\tneedle: string,\n): boolean {\n\treturn screen.split(/\\r?\\n/).some((line) => line.trim() === needle);\n}\n\nfunction countGroups(groups: Array<string | undefined>): Map<string, number> {\n\tconst counts = new Map<string, number>();\n\tfor (const group of groups) {\n\t\tassert.ok(group);\n\t\tcounts.set(group, (counts.get(group) ?? 0) + 1);\n\t}\n\treturn counts;\n}\n"]}
@@ -0,0 +1,70 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import { type Static } from "@sinclair/typebox";
3
+ import { type AgentCatalog, type AgentDefaults, type AgentDiagnostic, type ListedAgentDefinition, type SubagentSessionMode } from "../../maestro/core/roles/discovery.ts";
4
+ import type { TaskPreferences } from "../../maestro/core/config/task-model-types.ts";
5
+ export declare function buildSubagentRoutingGuidelines(catalog?: string, authenticatedTaskPreferences?: TaskPreferences, options?: {
6
+ launchRoster?: boolean;
7
+ }): string[];
8
+ export declare const SubagentParams: import("@sinclair/typebox").TObject<{
9
+ name: import("@sinclair/typebox").TString;
10
+ task: import("@sinclair/typebox").TString;
11
+ agent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
12
+ systemPrompt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
13
+ model: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
14
+ thinking: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max">[]>>;
15
+ skills: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
16
+ tools: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
17
+ cwd: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
18
+ worktree: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
19
+ branch: import("@sinclair/typebox").TString;
20
+ base: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
21
+ }>, import("@sinclair/typebox").TNull]>>;
22
+ fork: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
23
+ persistent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
24
+ notify: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
25
+ accept: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
26
+ run: import("@sinclair/typebox").TString;
27
+ maxRetries: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
28
+ timeoutSec: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
29
+ paths: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
30
+ }>>;
31
+ interactive: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
32
+ }>;
33
+ /**
34
+ * Resolve the effective set of denied tool names from agent defaults.
35
+ * `spawning: false` expands to all SPAWNING_TOOLS.
36
+ * `deny-tools` adds individual tool names on top.
37
+ */
38
+ export declare function resolveDenyTools(agentDefs: AgentDefaults | null): Set<string>;
39
+ export declare function discoverAgentCatalog(pi?: Pick<ExtensionAPI, "events">): AgentCatalog;
40
+ export declare function missingRoleMessage(agentName: string): string;
41
+ export declare function formatVisibleAgentDefinitions(agents: ListedAgentDefinition[]): string[];
42
+ export declare function formatAgentDiagnostics(diagnostics: AgentDiagnostic[]): string[];
43
+ export declare function resolveEffectiveSessionMode(params: Static<typeof SubagentParams>, agentDefs: AgentDefaults | null): SubagentSessionMode;
44
+ interface LaunchBehavior {
45
+ sessionMode: SubagentSessionMode;
46
+ seededSessionMode: "lineage-only" | "fork" | null;
47
+ inheritsConversationContext: boolean;
48
+ taskDelivery: "direct" | "artifact";
49
+ }
50
+ export declare function resolveLaunchBehavior(params: Static<typeof SubagentParams>, agentDefs: AgentDefaults | null): LaunchBehavior;
51
+ /**
52
+ * Decide whether a subagent is interactive (user-driven, long-running).
53
+ *
54
+ * Resolution order:
55
+ * 1. Explicit `interactive` tool parameter wins.
56
+ * 2. Explicit `interactive` frontmatter field on the agent.
57
+ * 3. Default: the inverse of `auto-exit`. Agents that auto-exit are
58
+ * autonomous and the parent session should be woken on stall/recovery
59
+ * transitions. Agents that don't auto-exit are driven by the user in
60
+ * their own pane, and stall pings are noise.
61
+ *
62
+ * Bare `subagent({ name, task })` calls have no agent defs; they auto-exit
63
+ * unless the caller passes `interactive: true`.
64
+ */
65
+ export declare function resolveEffectivePersistent(params: Static<typeof SubagentParams>, agentDefs: AgentDefaults | null): boolean;
66
+ export declare function resolveEffectiveAutoExit(params: Static<typeof SubagentParams>, agentDefs: AgentDefaults | null): boolean;
67
+ export declare function resolveEffectiveInteractive(params: Static<typeof SubagentParams>, agentDefs: AgentDefaults | null): boolean;
68
+ export declare function loadAgentDefaults(agentName: string, pi?: Pick<ExtensionAPI, "events">): ListedAgentDefinition | null;
69
+ export {};
70
+ //# sourceMappingURL=catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/catalog.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,MAAM,uCAAuC,CAAC;AAM/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAMrF,wBAAgB,8BAA8B,CAC7C,OAAO,CAAC,EAAE,MAAM,EAChB,4BAA4B,CAAC,EAAE,eAAe,EAC9C,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,MAAM,EAAE,CAoBV;AAUD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EA2HzB,CAAC;AAcH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAoB7E;AAED,wBAAgB,oBAAoB,CACnC,EAAE,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAC/B,YAAY,CAQd;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAQD,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,qBAAqB,EAAE,GAC7B,MAAM,EAAE,CAYV;AAED,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,eAAe,EAAE,GAC5B,MAAM,EAAE,CAKV;AAED,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACrC,SAAS,EAAE,aAAa,GAAG,IAAI,GAC7B,mBAAmB,CAIrB;AAED,UAAU,cAAc;IACvB,WAAW,EAAE,mBAAmB,CAAC;IACjC,iBAAiB,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,2BAA2B,EAAE,OAAO,CAAC;IACrC,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACrC,SAAS,EAAE,aAAa,GAAG,IAAI,GAC7B,cAAc,CAShB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACrC,SAAS,EAAE,aAAa,GAAG,IAAI,GAC7B,OAAO,CAET;AAED,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACrC,SAAS,EAAE,aAAa,GAAG,IAAI,GAC7B,OAAO,CAQT;AAED,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACrC,SAAS,EAAE,aAAa,GAAG,IAAI,GAC7B,OAAO,CAKT;AAED,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,MAAM,EACjB,EAAE,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAC/B,qBAAqB,GAAG,IAAI,CAK9B"}