@nubl/maestro 0.0.0 → 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 +56 -3
  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 @@
1
+ {"version":3,"file":"delegated-marker.js","sourceRoot":"","sources":["../../../maestro/runtime/delegated-marker.ts"],"names":[],"mappings":"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","sourcesContent":["/** Structural transport results; the terminal host supplies socket callbacks. */\nexport type PaneTokenOutcome = \"answered\" | \"pane-missing\" | \"failed\";\nexport type PaneAgentSessionRead =\n\t| { kind: \"session\"; path?: string }\n\t| { kind: \"none\" }\n\t| { kind: \"pane-missing\" }\n\t| { kind: \"failed\"; reason: string };\n\n/** The pane token the Pi Herdr Agents Sidebar plugin reads. */\nexport const DELEGATED_MARKER_TOKEN = \"piha_delegated_v1\";\n/** Recently classified as a delegated child; never proof of a live occupant. */\nexport const DELEGATED_MARKER_VALUE = \"live\";\n/** One stable source: a pane accepts sequenced reports from at most 32. */\nexport const DELEGATED_MARKER_SOURCE = \"pi-herdr-agents\";\n/** Bounds a leftover marker after the last write Herdr applied, not liveness. */\nexport const DELEGATED_MARKER_TTL_MS = 15_000;\n/**\n * Renewal rides on supervision observations: the 4.8s reconciliation, or\n * 1s fallback polling. Both leave several renewals inside one TTL.\n */\nexport const DELEGATED_MARKER_RENEW_MS = 4_000;\n/**\n * Consecutive failed renewal reads or writes before a live marker stops; its\n * TTL ends it. Discovery instead retries until its window ends.\n */\nexport const DELEGATED_MARKER_MAX_FAILURES = 3;\n/** How long a new marker waits for Herdr to report the child's session. */\nexport const DELEGATED_MARKER_DISCOVERY_MS = 15_000;\nexport const DELEGATED_MARKER_DISCOVERY_POLL_MS = 250;\n\nexport type MarkerWriter = (write: {\n\tpaneId: string;\n\tseq: number;\n\tlive: boolean;\n}) => Promise<PaneTokenOutcome>;\n\n/** The agent session Herdr currently stores for a pane. */\nexport type MarkerSessionReader = (\n\tpaneId: string,\n) => Promise<PaneAgentSessionRead>;\n\ntype MarkerState =\n\t| { kind: \"pending\" }\n\t| { kind: \"live\"; lastSentAt: number }\n\t| { kind: \"retired\" };\n\nfunction unrefSleep(ms: number): Promise<void> {\n\t// Discovery must never hold the parent process open.\n\treturn new Promise((resolve) => setTimeout(resolve, ms).unref());\n}\n\n/**\n * This parent process's marker writes. Every pane shares one sequence that\n * starts at wall-clock microseconds, so a restarted parent still outranks\n * its predecessor's writes unless the clock moved backwards.\n */\nexport class DelegatedMarkers {\n\treadonly write: MarkerWriter;\n\treadonly readSession: MarkerSessionReader;\n\treadonly now: () => number;\n\treadonly sleep: (ms: number) => Promise<void>;\n\tprivate lastSeq = 0;\n\n\tconstructor(options: {\n\t\twrite: MarkerWriter;\n\t\treadSession: MarkerSessionReader;\n\t\tnow?: () => number;\n\t\tsleep?: (ms: number) => Promise<void>;\n\t}) {\n\t\tthis.write = options.write;\n\t\tthis.readSession = options.readSession;\n\t\tthis.now = options.now ?? Date.now;\n\t\tthis.sleep = options.sleep ?? unrefSleep;\n\t}\n\n\t/**\n\t * A marker for one launched child. It publishes only once Herdr reports\n\t * the child's own session file for its pane; until then it never writes.\n\t */\n\tattach(child: { surface: string; sessionFile: string }): DelegatedMarker {\n\t\treturn new DelegatedMarker(this, child.surface, child.sessionFile);\n\t}\n\n\tnextSeq(): number {\n\t\tthis.lastSeq = Math.max(this.lastSeq + 1, this.now() * 1000);\n\t\treturn this.lastSeq;\n\t}\n}\n\n/**\n * One child's marker. Writes are serialized: at most one renewal is queued or\n * in flight, followed by at most one clear. Renewal continues only while\n * Herdr reports the child's session file for the pane. Herdr drops that\n * session when the child exits or another agent takes the pane, so a later\n * occupant never inherits the marker's renewal. With Herdr 0.9.4 or later a\n * suspended child (Ctrl-Z) keeps its session, also after it resumes with fg,\n * until it exits, so its marker stays live meanwhile.\n */\nexport class DelegatedMarker {\n\treadonly paneId: string;\n\treadonly sessionFile: string;\n\tprivate readonly owner: DelegatedMarkers;\n\tprivate state: MarkerState = { kind: \"pending\" };\n\tprivate sentLive = false;\n\tprivate renewalQueued = false;\n\tprivate failures = 0;\n\tprivate queue: Promise<void> = Promise.resolve();\n\tprivate readonly discovery: Promise<void>;\n\n\tconstructor(owner: DelegatedMarkers, paneId: string, sessionFile: string) {\n\t\tthis.owner = owner;\n\t\tthis.paneId = paneId;\n\t\tthis.sessionFile = sessionFile;\n\t\tthis.discovery = this.discover();\n\t}\n\n\tget kind(): MarkerState[\"kind\"] {\n\t\treturn this.state.kind;\n\t}\n\n\t/** Resolves once discovery ends and every write queued by then settles. */\n\tasync settled(): Promise<void> {\n\t\tawait this.discovery;\n\t\tfor (let seen: Promise<void> | undefined; seen !== this.queue; ) {\n\t\t\tseen = this.queue;\n\t\t\tawait seen;\n\t\t}\n\t}\n\n\t/** Called on each supervision observation; renews at most every 4s. */\n\trenew(): void {\n\t\tconst state = this.state;\n\t\tconst at = this.owner.now();\n\t\tif (\n\t\t\tstate.kind !== \"live\" ||\n\t\t\tthis.renewalQueued ||\n\t\t\tat - state.lastSentAt < DELEGATED_MARKER_RENEW_MS\n\t\t)\n\t\t\treturn;\n\t\tstate.lastSentAt = at;\n\t\tthis.renewalQueued = true;\n\t\tthis.queue = this.queue.then(() => this.renewal());\n\t}\n\n\t/** Idempotent. Clears the token if any live write may have reached Herdr. */\n\tretire(): void {\n\t\tif (this.state.kind === \"retired\") return;\n\t\tthis.state = { kind: \"retired\" };\n\t\tif (this.sentLive) this.queue = this.queue.then(() => this.send(false));\n\t}\n\n\tprivate async discover(): Promise<void> {\n\t\tconst deadline = this.owner.now() + DELEGATED_MARKER_DISCOVERY_MS;\n\t\tfor (;;) {\n\t\t\tif (this.state.kind !== \"pending\") return;\n\t\t\tconst read = await this.read();\n\t\t\tif (this.state.kind !== \"pending\") return;\n\t\t\tif (this.owns(read)) {\n\t\t\t\tthis.state = { kind: \"live\", lastSentAt: this.owner.now() };\n\t\t\t\tthis.queue = this.queue.then(() => this.send(true));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (read.kind === \"pane-missing\" || this.owner.now() >= deadline) {\n\t\t\t\tthis.state = { kind: \"retired\" };\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait this.owner.sleep(DELEGATED_MARKER_DISCOVERY_POLL_MS);\n\t\t}\n\t}\n\n\tprivate async renewal(): Promise<void> {\n\t\t// The guard holds until this renewal's read and write settle, so a slow\n\t\t// renewal never lets another queue behind it.\n\t\ttry {\n\t\t\t// A renewal queued before retirement is dropped, never sent after it.\n\t\t\tif (this.state.kind !== \"live\") return;\n\t\t\tconst read = await this.read();\n\t\t\tif (this.state.kind !== \"live\") return;\n\t\t\tif (this.owns(read)) await this.send(true);\n\t\t\telse if (read.kind === \"pane-missing\") this.state = { kind: \"retired\" };\n\t\t\telse if (read.kind === \"failed\") this.fail();\n\t\t\t// No session or another one: the child exited or the pane was reused.\n\t\t\telse this.retire();\n\t\t} finally {\n\t\t\tthis.renewalQueued = false;\n\t\t}\n\t}\n\n\tprivate owns(read: PaneAgentSessionRead): boolean {\n\t\treturn read.kind === \"session\" && read.path === this.sessionFile;\n\t}\n\n\tprivate async read(): Promise<PaneAgentSessionRead> {\n\t\ttry {\n\t\t\treturn await this.owner.readSession(this.paneId);\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tkind: \"failed\",\n\t\t\t\treason: error instanceof Error ? error.message : String(error),\n\t\t\t};\n\t\t}\n\t}\n\n\tprivate fail(): void {\n\t\tif (++this.failures >= DELEGATED_MARKER_MAX_FAILURES) this.retire();\n\t}\n\n\tprivate async send(live: boolean): Promise<void> {\n\t\tif (live && this.state.kind !== \"live\") return;\n\t\tif (live) this.sentLive = true;\n\t\tlet outcome: PaneTokenOutcome;\n\t\ttry {\n\t\t\toutcome = await this.owner.write({\n\t\t\t\tpaneId: this.paneId,\n\t\t\t\tseq: this.owner.nextSeq(),\n\t\t\t\tlive,\n\t\t\t});\n\t\t} catch {\n\t\t\toutcome = \"failed\";\n\t\t}\n\t\t// A late result never revives or reclassifies a retired marker.\n\t\tif (!live || this.state.kind !== \"live\") return;\n\t\tif (outcome === \"answered\") this.failures = 0;\n\t\telse if (outcome === \"pane-missing\") this.state = { kind: \"retired\" };\n\t\telse this.fail();\n\t}\n}\n"]}
@@ -0,0 +1,25 @@
1
+ import type { HerdrBinding } from "../core/config/herdr-config.ts";
2
+ import type { PaneConfig } from "../core/config/pane-config.ts";
3
+ import type { SurfaceProvider } from "../core/surface-provider.ts";
4
+ import type { ScriptShellResolver } from "../core/script-launch.ts";
5
+ import type { PiLaunchSnapshot } from "./pi-run-session-types.ts";
6
+ import type { MarkerWriter, MarkerSessionReader } from "./delegated-marker.ts";
7
+ /**
8
+ * Explicit terminal-host composition for the Pi run session. The terminal host
9
+ * owns backend selection, concrete providers and the socket marker transport;
10
+ * the run session only calls these. Injected infrastructure never consults it.
11
+ */
12
+ export interface HostSurfaceBinding {
13
+ /** Resolves the current binding on every load; reload compares it to the owner's. */
14
+ resolve(configDir: string, examplePath: string, platform?: NodeJS.Platform): HerdrBinding;
15
+ /** Creates the owning provider once, when a new owner is composed. */
16
+ createProvider(binding: HerdrBinding, paneConfig: PaneConfig, resolveScriptShell: ScriptShellResolver): SurfaceProvider;
17
+ /** Called for every legacy launch, with that session's cwd and trust. */
18
+ createLaunchProvider(snapshot: PiLaunchSnapshot): SurfaceProvider;
19
+ /** Sidebar marker transport for legacy panes, or none outside a socket pane. */
20
+ markers?(): {
21
+ write: MarkerWriter;
22
+ readSession: MarkerSessionReader;
23
+ } | undefined;
24
+ }
25
+ //# sourceMappingURL=host-surface-binding.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host-surface-binding.d.ts","sourceRoot":"","sources":["../../../maestro/runtime/host-surface-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,qFAAqF;IACrF,OAAO,CACN,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GACxB,YAAY,CAAC;IAChB,sEAAsE;IACtE,cAAc,CACb,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,UAAU,EACtB,kBAAkB,EAAE,mBAAmB,GACrC,eAAe,CAAC;IACnB,yEAAyE;IACzE,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAClE,gFAAgF;IAChF,OAAO,CAAC,IACL;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,WAAW,EAAE,mBAAmB,CAAA;KAAE,GACzD,SAAS,CAAC;CACb"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=host-surface-binding.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host-surface-binding.js","sourceRoot":"","sources":["../../../maestro/runtime/host-surface-binding.ts"],"names":[],"mappings":"","sourcesContent":["import type { HerdrBinding } from \"../core/config/herdr-config.ts\";\nimport type { PaneConfig } from \"../core/config/pane-config.ts\";\nimport type { SurfaceProvider } from \"../core/surface-provider.ts\";\nimport type { ScriptShellResolver } from \"../core/script-launch.ts\";\nimport type { PiLaunchSnapshot } from \"./pi-run-session-types.ts\";\nimport type { MarkerWriter, MarkerSessionReader } from \"./delegated-marker.ts\";\n\n/**\n * Explicit terminal-host composition for the Pi run session. The terminal host\n * owns backend selection, concrete providers and the socket marker transport;\n * the run session only calls these. Injected infrastructure never consults it.\n */\nexport interface HostSurfaceBinding {\n\t/** Resolves the current binding on every load; reload compares it to the owner's. */\n\tresolve(\n\t\tconfigDir: string,\n\t\texamplePath: string,\n\t\tplatform?: NodeJS.Platform,\n\t): HerdrBinding;\n\t/** Creates the owning provider once, when a new owner is composed. */\n\tcreateProvider(\n\t\tbinding: HerdrBinding,\n\t\tpaneConfig: PaneConfig,\n\t\tresolveScriptShell: ScriptShellResolver,\n\t): SurfaceProvider;\n\t/** Called for every legacy launch, with that session's cwd and trust. */\n\tcreateLaunchProvider(snapshot: PiLaunchSnapshot): SurfaceProvider;\n\t/** Sidebar marker transport for legacy panes, or none outside a socket pane. */\n\tmarkers?():\n\t\t| { write: MarkerWriter; readSession: MarkerSessionReader }\n\t\t| undefined;\n}\n"]}
@@ -0,0 +1,10 @@
1
+ export { createRunSession } from "./run-session.ts";
2
+ export type { CancelReport, DeliveryDecision, FinalizeControl, OwnedRunAttempt, PreparedRun, RunObservation, RunSession, RunSessionHooks, RunSessionOperations, RunSessionOptions, RuntimeCandidate, } from "./run-session.ts";
3
+ export { defaultRetainSurface } from "./surface-retention.ts";
4
+ export { startTaskModelInit } from "./task-model-init.ts";
5
+ export type { TaskModelInitOutcome } from "./task-model-init.ts";
6
+ export { createDefaultRunSession, observePiActivity, } from "./pi-run-session.ts";
7
+ export type { DefaultRunSessionOptions, PiLaunchSnapshot, PiLaunchInput, PiAttemptSnapshot, PiResumeInput, PiWorktreeLaunch, WorktreeHandoffBase, PiWorktreeHandoff, PiWorktreeHandoffInput, PiRunRecord, PiStartedMetadata, PiCompletedMetadata, PiPersistentEvent, PiLedgerEntry, PiSendAcknowledgement, PiStopAcknowledgement, PiPersistentIO, PiSettlementIO, PiPersistentHostOperations, PiProgressEvidence, PiRunSessionHooks, PiRunSessionInfrastructure, PiRunSession, } from "./pi-run-session-types.ts";
8
+ export type { SummarySource } from "../adapters/pi/session.ts";
9
+ export { resolveProjectTrusted } from "../adapters/pi/script-shell.ts";
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../maestro/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,WAAW,EACX,cAAc,EACd,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACN,uBAAuB,EACvB,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,YAAY,GACZ,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}
@@ -0,0 +1,6 @@
1
+ export { createRunSession } from "./run-session.js";
2
+ export { defaultRetainSurface } from "./surface-retention.js";
3
+ export { startTaskModelInit } from "./task-model-init.js";
4
+ export { createDefaultRunSession, observePiActivity, } from "./pi-run-session.js";
5
+ export { resolveProjectTrusted } from "../adapters/pi/script-shell.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../maestro/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAcpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACN,uBAAuB,EACvB,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AA2B7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC","sourcesContent":["export { createRunSession } from \"./run-session.ts\";\nexport type {\n\tCancelReport,\n\tDeliveryDecision,\n\tFinalizeControl,\n\tOwnedRunAttempt,\n\tPreparedRun,\n\tRunObservation,\n\tRunSession,\n\tRunSessionHooks,\n\tRunSessionOperations,\n\tRunSessionOptions,\n\tRuntimeCandidate,\n} from \"./run-session.ts\";\nexport { defaultRetainSurface } from \"./surface-retention.ts\";\nexport { startTaskModelInit } from \"./task-model-init.ts\";\nexport type { TaskModelInitOutcome } from \"./task-model-init.ts\";\nexport {\n\tcreateDefaultRunSession,\n\tobservePiActivity,\n} from \"./pi-run-session.ts\";\nexport type {\n\tDefaultRunSessionOptions,\n\tPiLaunchSnapshot,\n\tPiLaunchInput,\n\tPiAttemptSnapshot,\n\tPiResumeInput,\n\tPiWorktreeLaunch,\n\tWorktreeHandoffBase,\n\tPiWorktreeHandoff,\n\tPiWorktreeHandoffInput,\n\tPiRunRecord,\n\tPiStartedMetadata,\n\tPiCompletedMetadata,\n\tPiPersistentEvent,\n\tPiLedgerEntry,\n\tPiSendAcknowledgement,\n\tPiStopAcknowledgement,\n\tPiPersistentIO,\n\tPiSettlementIO,\n\tPiPersistentHostOperations,\n\tPiProgressEvidence,\n\tPiRunSessionHooks,\n\tPiRunSessionInfrastructure,\n\tPiRunSession,\n} from \"./pi-run-session-types.ts\";\nexport type { SummarySource } from \"../adapters/pi/session.ts\";\nexport { resolveProjectTrusted } from \"../adapters/pi/script-shell.ts\";\n"]}
@@ -0,0 +1,7 @@
1
+ import type { WorktreeOperations } from "../core/worktree.ts";
2
+ import type { PiPersistentIO } from "./pi-run-session-types.ts";
3
+ /** Persistent inbox, event and ledger I/O, reading the owner's live worktree operations. */
4
+ export declare function createPiPersistentIO(state: {
5
+ readonly worktreeOperations: WorktreeOperations;
6
+ }): PiPersistentIO;
7
+ //# sourceMappingURL=pi-persistent-io.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-persistent-io.d.ts","sourceRoot":"","sources":["../../../maestro/runtime/pi-persistent-io.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAS9D,OAAO,KAAK,EAEX,cAAc,EAEd,MAAM,2BAA2B,CAAC;AAEnC,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CAChD,GAAG,cAAc,CAiFjB"}
@@ -0,0 +1,64 @@
1
+ import { existsSync } from "node:fs";
2
+ import { appendPersistentDeliveryLedger, readPersistentDeliveryLedger, readPersistentTaskEvents, writePersistentTaskInbox, getNewEntries, findLastAssistantSummary, } from "../adapters/pi/session.js";
3
+ /** Persistent inbox, event and ledger I/O, reading the owner's live worktree operations. */
4
+ export function createPiPersistentIO(state) {
5
+ const io = {
6
+ inspectWorktree: async (r) => r.worktree
7
+ ? state.worktreeOperations.captureWorktreeHandoff(r.worktree)
8
+ : undefined,
9
+ readEvents: (r) => readPersistentTaskEvents(r.sessionFile),
10
+ readLedger: (r) => readPersistentDeliveryLedger(r.sessionFile),
11
+ readTaskSummary: (r) => existsSync(r.sessionFile)
12
+ ? (findLastAssistantSummary(getNewEntries(r.sessionFile, 0)) ?? {
13
+ summary: "Persistent specialist completed without output.",
14
+ summarySource: "host",
15
+ })
16
+ : {
17
+ summary: "Persistent specialist session is unavailable.",
18
+ summarySource: "host",
19
+ },
20
+ rejectBusy(r, task) {
21
+ ledger(r, task, "rejected-busy");
22
+ },
23
+ dispatch(r, task, text) {
24
+ const inbox = writePersistentTaskInbox(r.sessionFile, (r.inboxSequence = (r.inboxSequence ?? 0) + 1), { task, message: text });
25
+ r.taskId = task;
26
+ (r.issuedTaskIds ??= []).push(task);
27
+ ledger(r, task, "dispatched");
28
+ return inbox;
29
+ },
30
+ requestStop(r) {
31
+ const task = r.taskId ?? "stop";
32
+ if (r.taskId &&
33
+ !io
34
+ .readLedger(r)
35
+ .some((row) => row.task === task &&
36
+ row.generation === r.generationId &&
37
+ row.outcome === "stop-pending"))
38
+ ledger(r, task, "stop-pending");
39
+ writePersistentTaskInbox(r.sessionFile, (r.inboxSequence = (r.inboxSequence ?? 0) + 1), { type: "stop", task, message: "" });
40
+ },
41
+ acknowledge(r, event) {
42
+ const row = ledger(r, event.task, event.type === "help-request" ? "help-requested" : "delivered");
43
+ if (r.taskId === event.task)
44
+ r.taskId = undefined;
45
+ if (event.type === "task-done")
46
+ r.tasksCompleted = (r.tasksCompleted ?? 0) + 1;
47
+ return row;
48
+ },
49
+ recordStopped(r) {
50
+ ledger(r, "stop", "stopped");
51
+ },
52
+ };
53
+ function ledger(r, task, outcome) {
54
+ return appendPersistentDeliveryLedger(r.sessionFile, {
55
+ task,
56
+ outcome,
57
+ generation: r.generationId,
58
+ logicalId: r.logicalId,
59
+ policyHash: r.policyHash,
60
+ });
61
+ }
62
+ return io;
63
+ }
64
+ //# sourceMappingURL=pi-persistent-io.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-persistent-io.js","sourceRoot":"","sources":["../../../maestro/runtime/pi-persistent-io.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport type { WorktreeOperations } from \"../core/worktree.ts\";\nimport {\n\tappendPersistentDeliveryLedger,\n\treadPersistentDeliveryLedger,\n\treadPersistentTaskEvents,\n\twritePersistentTaskInbox,\n\tgetNewEntries,\n\tfindLastAssistantSummary,\n} from \"../adapters/pi/session.ts\";\nimport type {\n\tPiLedgerEntry,\n\tPiPersistentIO,\n\tPiRunRecord,\n} from \"./pi-run-session-types.ts\";\n\n/** Persistent inbox, event and ledger I/O, reading the owner's live worktree operations. */\nexport function createPiPersistentIO(state: {\n\treadonly worktreeOperations: WorktreeOperations;\n}): PiPersistentIO {\n\tconst io: PiPersistentIO = {\n\t\tinspectWorktree: async (r) =>\n\t\t\tr.worktree\n\t\t\t\t? state.worktreeOperations.captureWorktreeHandoff(r.worktree)\n\t\t\t\t: undefined,\n\t\treadEvents: (r) => readPersistentTaskEvents(r.sessionFile),\n\t\treadLedger: (r) => readPersistentDeliveryLedger(r.sessionFile),\n\t\treadTaskSummary: (r) =>\n\t\t\texistsSync(r.sessionFile)\n\t\t\t\t? (findLastAssistantSummary(getNewEntries(r.sessionFile, 0)) ?? {\n\t\t\t\t\t\tsummary: \"Persistent specialist completed without output.\",\n\t\t\t\t\t\tsummarySource: \"host\",\n\t\t\t\t\t})\n\t\t\t\t: {\n\t\t\t\t\t\tsummary: \"Persistent specialist session is unavailable.\",\n\t\t\t\t\t\tsummarySource: \"host\",\n\t\t\t\t\t},\n\t\trejectBusy(r, task) {\n\t\t\tledger(r, task, \"rejected-busy\");\n\t\t},\n\t\tdispatch(r, task, text) {\n\t\t\tconst inbox = writePersistentTaskInbox(\n\t\t\t\tr.sessionFile,\n\t\t\t\t(r.inboxSequence = (r.inboxSequence ?? 0) + 1),\n\t\t\t\t{ task, message: text },\n\t\t\t);\n\t\t\tr.taskId = task;\n\t\t\t(r.issuedTaskIds ??= []).push(task);\n\t\t\tledger(r, task, \"dispatched\");\n\t\t\treturn inbox;\n\t\t},\n\t\trequestStop(r) {\n\t\t\tconst task = r.taskId ?? \"stop\";\n\t\t\tif (\n\t\t\t\tr.taskId &&\n\t\t\t\t!io\n\t\t\t\t\t.readLedger(r)\n\t\t\t\t\t.some(\n\t\t\t\t\t\t(row) =>\n\t\t\t\t\t\t\trow.task === task &&\n\t\t\t\t\t\t\trow.generation === r.generationId &&\n\t\t\t\t\t\t\trow.outcome === \"stop-pending\",\n\t\t\t\t\t)\n\t\t\t)\n\t\t\t\tledger(r, task, \"stop-pending\");\n\t\t\twritePersistentTaskInbox(\n\t\t\t\tr.sessionFile,\n\t\t\t\t(r.inboxSequence = (r.inboxSequence ?? 0) + 1),\n\t\t\t\t{ type: \"stop\", task, message: \"\" },\n\t\t\t);\n\t\t},\n\t\tacknowledge(r, event) {\n\t\t\tconst row = ledger(\n\t\t\t\tr,\n\t\t\t\tevent.task,\n\t\t\t\tevent.type === \"help-request\" ? \"help-requested\" : \"delivered\",\n\t\t\t);\n\t\t\tif (r.taskId === event.task) r.taskId = undefined;\n\t\t\tif (event.type === \"task-done\")\n\t\t\t\tr.tasksCompleted = (r.tasksCompleted ?? 0) + 1;\n\t\t\treturn row;\n\t\t},\n\t\trecordStopped(r) {\n\t\t\tledger(r, \"stop\", \"stopped\");\n\t\t},\n\t};\n\tfunction ledger(\n\t\tr: PiRunRecord,\n\t\ttask: string,\n\t\toutcome: PiLedgerEntry[\"outcome\"],\n\t): PiLedgerEntry {\n\t\treturn appendPersistentDeliveryLedger(r.sessionFile, {\n\t\t\ttask,\n\t\t\toutcome,\n\t\t\tgeneration: r.generationId!,\n\t\t\tlogicalId: r.logicalId!,\n\t\t\tpolicyHash: r.policyHash!,\n\t\t});\n\t}\n\treturn io;\n}\n"]}
@@ -0,0 +1,328 @@
1
+ import type { AgentHandle, Task, Role, ThinkingLevel, SurfaceHandle, SubagentLifecycle, RunResult } from "../core/types.ts";
2
+ import type { SurfaceProvider, WorktreeSurfaceInfo } from "../core/surface-provider.ts";
3
+ import type { ProcessIdentityProbe } from "../adapters/pi/process-identity.ts";
4
+ import type { AcceptRunner } from "../adapters/pi/accept-runner.ts";
5
+ import type { AcceptOutcome, AcceptSpec } from "../core/accept.ts";
6
+ import type { PiLaunchOperations } from "../adapters/pi/launch-operations.ts";
7
+ import type { WorktreeOperations, WorktreeLaunch, WorktreeHandoff } from "../core/worktree.ts";
8
+ import type { WorktreeCleanupOperations } from "../core/worktree-cleanup.ts";
9
+ import type { AttributedSummary, SummarySource } from "../adapters/pi/session.ts";
10
+ import type { SupervisionCoordinator } from "../core/supervision.ts";
11
+ import type { ParentRuntime, ResolvedRuntimePlan, ModelRegistryAdapter } from "../core/routing.ts";
12
+ import type { PaneConfig } from "../core/config/pane-config.ts";
13
+ import type { MarkerSessionReader, MarkerWriter } from "./delegated-marker.ts";
14
+ import type { HostSurfaceBinding } from "./host-surface-binding.ts";
15
+ import type { RunSession, RunObservation, DeliveryDecision } from "./run-session.ts";
16
+ export interface PiLaunchSnapshot {
17
+ parent: {
18
+ cwd: string;
19
+ invocationCwd?: string;
20
+ sessionFile: string;
21
+ sessionId: string;
22
+ sessionDir: string;
23
+ agentDir?: string;
24
+ };
25
+ parentRuntime?: ParentRuntime;
26
+ modelRegistry: ModelRegistryAdapter;
27
+ paneConfig: PaneConfig;
28
+ /**
29
+ * Where a Windows launch reads Pi's `shellPath` from: the launching
30
+ * session's cwd and project-trust decision. Absent means untrusted.
31
+ */
32
+ scriptShell?: {
33
+ cwd: string;
34
+ projectTrusted: boolean;
35
+ };
36
+ }
37
+ export interface PiLaunchInput {
38
+ task: Task;
39
+ role: Role;
40
+ plans: readonly [ResolvedRuntimePlan, ...ResolvedRuntimePlan[]];
41
+ resolved: {
42
+ agent?: string;
43
+ cwd?: string;
44
+ roleCwd?: string;
45
+ tools?: string;
46
+ };
47
+ identity: {
48
+ id: string;
49
+ logicalId: string;
50
+ generationId: string;
51
+ taskId: string;
52
+ };
53
+ warning?: string;
54
+ surface?: SurfaceHandle;
55
+ /**
56
+ * Existing host normalization may re-read role files for each actual retry
57
+ * launch, and may wait (for example, across a parent reload) before it does.
58
+ */
59
+ prepareAttempt?(candidateIndex: number, cancelled: AbortSignal): PiAttemptSnapshot | Promise<PiAttemptSnapshot>;
60
+ }
61
+ export interface PiAttemptSnapshot {
62
+ task: Task;
63
+ role: Role;
64
+ resolved: {
65
+ agent?: string;
66
+ cwd?: string;
67
+ roleCwd?: string;
68
+ tools?: string;
69
+ };
70
+ identity: {
71
+ id: string;
72
+ logicalId: string;
73
+ generationId: string;
74
+ taskId: string;
75
+ };
76
+ snapshot: PiLaunchSnapshot;
77
+ }
78
+ export interface PiResumeInput {
79
+ taskId: string;
80
+ name: string;
81
+ sessionPath: string;
82
+ message?: string;
83
+ autoExit?: boolean;
84
+ }
85
+ export type PiWorktreeLaunch = WorktreeLaunch;
86
+ export type WorktreeHandoffBase = Omit<WorktreeLaunch, "workspaceId" | "paneId">;
87
+ export type PiWorktreeHandoff = WorktreeHandoff;
88
+ /** Structural view of the adapter's actual mutable child, not a copied registry row. */
89
+ export interface PiRunRecord {
90
+ launchFailure?: string;
91
+ id: string;
92
+ name: string;
93
+ task: string;
94
+ agent?: string;
95
+ surface: string;
96
+ startTime: number;
97
+ sessionFile: string;
98
+ launchScriptFile: string;
99
+ activityFile: string;
100
+ interactive: boolean;
101
+ runtimePlan: ResolvedRuntimePlan | undefined;
102
+ worktree?: PiWorktreeLaunch;
103
+ lifecycle: SubagentLifecycle;
104
+ persistent?: boolean;
105
+ logicalId?: string;
106
+ generationId?: string;
107
+ policyHash?: string;
108
+ policyTools?: string[] | null;
109
+ policyDeniedTools?: string[];
110
+ tasksCompleted?: number;
111
+ taskId?: string;
112
+ /** Task IDs this parent dispatched; the child-writable ledger never decides. */
113
+ issuedTaskIds?: string[];
114
+ /** The parent opted this specialist into notices at launch (ADR-0019). */
115
+ notify?: boolean;
116
+ inboxSequence?: number;
117
+ observedTaskEvents?: number;
118
+ stopState?: "requested" | "pending" | "failed";
119
+ stopFailure?: string;
120
+ crashNotified?: boolean;
121
+ /** Presentation of the latest operator cancel; the kernel owns the intent. */
122
+ cancelState?: "requested" | "confirmed" | "unconfirmed";
123
+ /** Where the child runs; the accept re-check runs here. */
124
+ cwd?: string;
125
+ accept?: AcceptSpec;
126
+ }
127
+ export interface PiStartedMetadata {
128
+ id: string;
129
+ name: string;
130
+ task: string;
131
+ agent?: string;
132
+ sessionFile: string;
133
+ launchScriptFile?: string;
134
+ model?: string;
135
+ thinking?: ThinkingLevel;
136
+ runtimePlan?: ResolvedRuntimePlan;
137
+ worktree?: PiWorktreeLaunch;
138
+ warning?: string;
139
+ status: "started" | "uncertain";
140
+ launchFailure?: string;
141
+ }
142
+ export interface PiCompletedMetadata {
143
+ run: RunResult;
144
+ name: string;
145
+ task: string;
146
+ agent?: string;
147
+ summary: string;
148
+ summarySource: SummarySource;
149
+ sessionFile?: string;
150
+ exitCode: number;
151
+ elapsed: number;
152
+ error?: string;
153
+ errorMessage?: string;
154
+ ping?: {
155
+ name: string;
156
+ message: string;
157
+ };
158
+ fallbackAttempts?: string[];
159
+ fallbackFailures?: {
160
+ model: string;
161
+ error: string;
162
+ }[];
163
+ runtimePlan?: ResolvedRuntimePlan;
164
+ worktree?: PiWorktreeHandoff;
165
+ /** The verdict; absent means no check was requested (`none`). */
166
+ accept?: AcceptOutcome;
167
+ logicalId?: string;
168
+ generationId?: string;
169
+ policyHash?: string;
170
+ }
171
+ export interface PiPersistentEvent {
172
+ version: 1;
173
+ type: "task-done" | "help-request" | "notice";
174
+ task: string;
175
+ generation: string;
176
+ at: string;
177
+ message?: string;
178
+ sequence?: number;
179
+ }
180
+ export interface PiLedgerEntry {
181
+ task: string;
182
+ outcome: "dispatched" | "delivered" | "rejected-busy" | "help-requested" | "stop-pending" | "stopped";
183
+ generation: string;
184
+ logicalId: string;
185
+ policyHash: string;
186
+ at: string;
187
+ }
188
+ export type PiSendAcknowledgement = {
189
+ id: string;
190
+ task: string;
191
+ inbox: string;
192
+ outcome: "dispatched";
193
+ } | {
194
+ error: string;
195
+ task?: string;
196
+ outcome?: "rejected-busy";
197
+ };
198
+ export type PiStopAcknowledgement = {
199
+ id: string;
200
+ name: string;
201
+ status: "stop_requested" | "stop_pending";
202
+ } | {
203
+ error: string;
204
+ id?: string;
205
+ name?: string;
206
+ };
207
+ /** Narrow I/O for the existing host persistent policy, not a task scheduler. */
208
+ export interface PiPersistentIO {
209
+ /** Raw events only; cursor indexes this array before generation filtering. */
210
+ readEvents(record: PiRunRecord): PiPersistentEvent[];
211
+ inspectWorktree(record: PiRunRecord): Promise<PiWorktreeHandoff | undefined>;
212
+ /** Explicit lazy read, once per drain with eligible post-cursor events. */
213
+ readLedger(record: PiRunRecord): PiLedgerEntry[];
214
+ /** Transcript read only for an undelivered task-done, never help/quiet wakes. */
215
+ readTaskSummary(record: PiRunRecord): AttributedSummary;
216
+ rejectBusy(record: PiRunRecord, task: string): void;
217
+ dispatch(record: PiRunRecord, task: string, text: string): string;
218
+ requestStop(record: PiRunRecord): void;
219
+ acknowledge(record: PiRunRecord, event: PiPersistentEvent): PiLedgerEntry;
220
+ recordStopped(record: PiRunRecord): void;
221
+ }
222
+ /** Run-scoped settlement I/O; only resumed acquisitions supply the late reader. */
223
+ export interface PiSettlementIO extends PiPersistentIO {
224
+ readResumeResult?(): AttributedSummary & {
225
+ sessionFile: string;
226
+ };
227
+ }
228
+ export interface PiPersistentHostOperations {
229
+ send(record: PiRunRecord, text: string, io: PiPersistentIO): PiSendAcknowledgement;
230
+ stop(record: PiRunRecord, timeoutMs: number, io: PiPersistentIO): PiStopAcknowledgement;
231
+ drain(record: PiRunRecord, io: PiPersistentIO): void;
232
+ }
233
+ export interface PiProgressEvidence {
234
+ updatedAt?: number;
235
+ classification: "blocked-tool" | "truncated-turn" | "generic-no-progress";
236
+ lastEntryKind: "assistant" | "tool-result" | "message" | "other" | "none";
237
+ }
238
+ export interface PiRunSessionHooks {
239
+ onSpawned?(record: PiRunRecord, started: PiStartedMetadata, task: Task): void | Promise<void>;
240
+ onObserved?(record: PiRunRecord, observation: RunObservation): void;
241
+ onSettled(record: PiRunRecord, result: PiCompletedMetadata, task: Task, io: PiSettlementIO): void | DeliveryDecision | Promise<void | DeliveryDecision>;
242
+ }
243
+ export interface PiRunSessionInfrastructure {
244
+ surfaceProvider: SurfaceProvider;
245
+ launchOperations: PiLaunchOperations;
246
+ worktreeOperations?: WorktreeOperations;
247
+ supervision: SupervisionCoordinator;
248
+ /** Kernel process-identity probe for worktree cancel; tests inject it. */
249
+ processProbe?: ProcessIdentityProbe;
250
+ /** The parent accept re-check's command runner; tests inject it. */
251
+ acceptRunner?: AcceptRunner;
252
+ /** Sidebar marker transport; no ambient discovery when injected. */
253
+ markerWriter?: MarkerWriter;
254
+ /** Sidebar marker session evidence; no ambient discovery when injected. */
255
+ markerSessionReader?: MarkerSessionReader;
256
+ }
257
+ export interface DefaultRunSessionOptions {
258
+ /**
259
+ * The terminal host's provider and marker composition. Required unless
260
+ * `infrastructure` supplies the closed test composition.
261
+ */
262
+ hostSurface?: HostSurfaceBinding;
263
+ /** Child reporter extension each launch loads; defaults to the protocol-only entry. */
264
+ childEntryPath?: string;
265
+ /** Test injection consumes the actual Stage 3 seams, not replacement launch logic. */
266
+ infrastructure?: PiRunSessionInfrastructure;
267
+ configDir: string;
268
+ configExamplePath: string;
269
+ /** Synchronous fresh snapshot, captured once at each launch/resume call. */
270
+ getLaunchSnapshot(): PiLaunchSnapshot;
271
+ roles: Role[];
272
+ hooks: PiRunSessionHooks;
273
+ persistent: PiPersistentHostOperations;
274
+ forcePolling: boolean;
275
+ /** Append one outcome-ledger line per model attempt. Default true. */
276
+ outcomeLedger?: boolean;
277
+ /** Host platform for the Windows support scope; tests inject win32. */
278
+ platform?: NodeJS.Platform;
279
+ }
280
+ export interface PiWorktreeHandoffInput {
281
+ name: string;
282
+ task: string;
283
+ branch: string;
284
+ leafId: string;
285
+ snapshot: PiLaunchSnapshot;
286
+ runtimePlan: ResolvedRuntimePlan;
287
+ }
288
+ export interface PiRunSession extends RunSession {
289
+ handoffWorktree(input: PiWorktreeHandoffInput): Promise<{
290
+ record: PiRunRecord;
291
+ focusError?: string;
292
+ }>;
293
+ createWorktreeCleanupOperations(input: {
294
+ manifestDir: string;
295
+ liveHolders: () => {
296
+ path: string;
297
+ persistent?: boolean;
298
+ }[];
299
+ managedRoot?: string;
300
+ }): WorktreeCleanupOperations;
301
+ spawnPi(input: PiLaunchInput): Promise<AgentHandle>;
302
+ /** Why this host refuses every managed-worktree operation, if it does. */
303
+ managedWorktreeRefusal(): string | undefined;
304
+ resumePi(input: PiResumeInput): Promise<AgentHandle>;
305
+ /** Live-run metadata queries; all undefined after terminal retirement. */
306
+ getRecord(taskId: string): PiRunRecord | undefined;
307
+ getStarted(taskId: string): PiStartedMetadata | undefined;
308
+ getCompleted(taskId: string): PiCompletedMetadata | undefined;
309
+ /** Live public Pi run ID -> control Task ID; undefined after retirement, not inbox ID. */
310
+ getControlTaskId(publicRunId: string): string | undefined;
311
+ availability(): {
312
+ available: boolean;
313
+ setupHint: string;
314
+ };
315
+ listWorktreeSurfaces(options?: {
316
+ cwd?: string;
317
+ timeoutMs?: number;
318
+ }): Promise<WorktreeSurfaceInfo[]>;
319
+ sendPersistent(taskId: string, text: string): Promise<PiSendAcknowledgement>;
320
+ stopPersistent(taskId: string, timeoutMs?: number): Promise<PiStopAcknowledgement>;
321
+ inspectProgress(taskId: string): PiProgressEvidence;
322
+ diagnostics(): {
323
+ mode: "wake+batch" | "polling(forced)" | "polling(fallback)";
324
+ watcherCount: number;
325
+ };
326
+ shutdown(reason: "reload" | "new" | "resume" | "fork" | "quit" | undefined): Promise<void>;
327
+ }
328
+ //# sourceMappingURL=pi-run-session-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-run-session-types.d.ts","sourceRoot":"","sources":["../../../maestro/runtime/pi-run-session-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=pi-run-session-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-run-session-types.js","sourceRoot":"","sources":["../../../maestro/runtime/pi-run-session-types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tAgentHandle,\n\tTask,\n\tRole,\n\tThinkingLevel,\n\tSurfaceHandle,\n\tSubagentLifecycle,\n\tRunResult,\n} from \"../core/types.ts\";\nimport type {\n\tSurfaceProvider,\n\tWorktreeSurfaceInfo,\n} from \"../core/surface-provider.ts\";\nimport type { ProcessIdentityProbe } from \"../adapters/pi/process-identity.ts\";\nimport type { AcceptRunner } from \"../adapters/pi/accept-runner.ts\";\nimport type { AcceptOutcome, AcceptSpec } from \"../core/accept.ts\";\nimport type { PiLaunchOperations } from \"../adapters/pi/launch-operations.ts\";\nimport type {\n\tWorktreeOperations,\n\tWorktreeLaunch,\n\tWorktreeHandoff,\n} from \"../core/worktree.ts\";\nimport type { WorktreeCleanupOperations } from \"../core/worktree-cleanup.ts\";\nimport type {\n\tAttributedSummary,\n\tSummarySource,\n} from \"../adapters/pi/session.ts\";\nimport type { SupervisionCoordinator } from \"../core/supervision.ts\";\nimport type {\n\tParentRuntime,\n\tResolvedRuntimePlan,\n\tModelRegistryAdapter,\n} from \"../core/routing.ts\";\nimport type { PaneConfig } from \"../core/config/pane-config.ts\";\nimport type { MarkerSessionReader, MarkerWriter } from \"./delegated-marker.ts\";\nimport type { HostSurfaceBinding } from \"./host-surface-binding.ts\";\nimport type {\n\tRunSession,\n\tRunObservation,\n\tDeliveryDecision,\n} from \"./run-session.ts\";\n\n// pi-herdr-agents extension\nexport interface PiLaunchSnapshot {\n\tparent: {\n\t\tcwd: string;\n\t\tinvocationCwd?: string;\n\t\tsessionFile: string;\n\t\tsessionId: string;\n\t\tsessionDir: string;\n\t\tagentDir?: string;\n\t};\n\tparentRuntime?: ParentRuntime;\n\tmodelRegistry: ModelRegistryAdapter;\n\tpaneConfig: PaneConfig;\n\t/**\n\t * Where a Windows launch reads Pi's `shellPath` from: the launching\n\t * session's cwd and project-trust decision. Absent means untrusted.\n\t */\n\tscriptShell?: { cwd: string; projectTrusted: boolean };\n}\n\n// pi-herdr-agents extension\nexport interface PiLaunchInput {\n\ttask: Task;\n\trole: Role;\n\tplans: readonly [ResolvedRuntimePlan, ...ResolvedRuntimePlan[]];\n\tresolved: { agent?: string; cwd?: string; roleCwd?: string; tools?: string };\n\tidentity: {\n\t\tid: string;\n\t\tlogicalId: string;\n\t\tgenerationId: string;\n\t\ttaskId: string;\n\t};\n\twarning?: string;\n\tsurface?: SurfaceHandle;\n\t/**\n\t * Existing host normalization may re-read role files for each actual retry\n\t * launch, and may wait (for example, across a parent reload) before it does.\n\t */\n\tprepareAttempt?(\n\t\tcandidateIndex: number,\n\t\tcancelled: AbortSignal,\n\t): PiAttemptSnapshot | Promise<PiAttemptSnapshot>;\n}\n// pi-herdr-agents extension\nexport interface PiAttemptSnapshot {\n\ttask: Task;\n\trole: Role;\n\tresolved: { agent?: string; cwd?: string; roleCwd?: string; tools?: string };\n\tidentity: {\n\t\tid: string;\n\t\tlogicalId: string;\n\t\tgenerationId: string;\n\t\ttaskId: string;\n\t};\n\tsnapshot: PiLaunchSnapshot;\n}\n\n// pi-herdr-agents extension\nexport interface PiResumeInput {\n\ttaskId: string;\n\tname: string;\n\tsessionPath: string;\n\tmessage?: string;\n\tautoExit?: boolean;\n}\n\n// pi-herdr-agents extension\nexport type PiWorktreeLaunch = WorktreeLaunch;\n// pi-herdr-agents extension\nexport type WorktreeHandoffBase = Omit<\n\tWorktreeLaunch,\n\t\"workspaceId\" | \"paneId\"\n>;\n// pi-herdr-agents extension\nexport type PiWorktreeHandoff = WorktreeHandoff;\n\n/** Structural view of the adapter's actual mutable child, not a copied registry row. */\n// pi-herdr-agents extension\nexport interface PiRunRecord {\n\tlaunchFailure?: string;\n\tid: string;\n\tname: string;\n\ttask: string;\n\tagent?: string;\n\tsurface: string;\n\tstartTime: number;\n\tsessionFile: string;\n\tlaunchScriptFile: string;\n\tactivityFile: string;\n\tinteractive: boolean;\n\truntimePlan: ResolvedRuntimePlan | undefined;\n\tworktree?: PiWorktreeLaunch;\n\tlifecycle: SubagentLifecycle;\n\tpersistent?: boolean;\n\tlogicalId?: string;\n\tgenerationId?: string;\n\tpolicyHash?: string;\n\tpolicyTools?: string[] | null;\n\tpolicyDeniedTools?: string[];\n\ttasksCompleted?: number;\n\ttaskId?: string;\n\t/** Task IDs this parent dispatched; the child-writable ledger never decides. */\n\tissuedTaskIds?: string[];\n\t/** The parent opted this specialist into notices at launch (ADR-0019). */\n\tnotify?: boolean;\n\tinboxSequence?: number;\n\tobservedTaskEvents?: number;\n\tstopState?: \"requested\" | \"pending\" | \"failed\";\n\tstopFailure?: string;\n\tcrashNotified?: boolean;\n\t/** Presentation of the latest operator cancel; the kernel owns the intent. */\n\tcancelState?: \"requested\" | \"confirmed\" | \"unconfirmed\";\n\t/** Where the child runs; the accept re-check runs here. */\n\tcwd?: string;\n\taccept?: AcceptSpec;\n}\n\n// pi-herdr-agents extension\nexport interface PiStartedMetadata {\n\tid: string;\n\tname: string;\n\ttask: string;\n\tagent?: string;\n\tsessionFile: string;\n\tlaunchScriptFile?: string;\n\tmodel?: string;\n\tthinking?: ThinkingLevel;\n\truntimePlan?: ResolvedRuntimePlan;\n\tworktree?: PiWorktreeLaunch;\n\twarning?: string;\n\tstatus: \"started\" | \"uncertain\";\n\tlaunchFailure?: string;\n}\n// pi-herdr-agents extension\nexport interface PiCompletedMetadata {\n\trun: RunResult;\n\tname: string;\n\ttask: string;\n\tagent?: string;\n\tsummary: string;\n\tsummarySource: SummarySource;\n\tsessionFile?: string;\n\texitCode: number;\n\telapsed: number;\n\terror?: string;\n\terrorMessage?: string;\n\tping?: { name: string; message: string };\n\tfallbackAttempts?: string[];\n\tfallbackFailures?: { model: string; error: string }[];\n\truntimePlan?: ResolvedRuntimePlan;\n\tworktree?: PiWorktreeHandoff;\n\t/** The verdict; absent means no check was requested (`none`). */\n\taccept?: AcceptOutcome;\n\tlogicalId?: string;\n\tgenerationId?: string;\n\tpolicyHash?: string;\n}\n\n// pi-herdr-agents extension\nexport interface PiPersistentEvent {\n\tversion: 1;\n\ttype: \"task-done\" | \"help-request\" | \"notice\";\n\ttask: string;\n\tgeneration: string;\n\tat: string;\n\tmessage?: string;\n\tsequence?: number;\n}\n// pi-herdr-agents extension\nexport interface PiLedgerEntry {\n\ttask: string;\n\toutcome:\n\t\t| \"dispatched\"\n\t\t| \"delivered\"\n\t\t| \"rejected-busy\"\n\t\t| \"help-requested\"\n\t\t| \"stop-pending\"\n\t\t| \"stopped\";\n\tgeneration: string;\n\tlogicalId: string;\n\tpolicyHash: string;\n\tat: string;\n}\n// pi-herdr-agents extension\nexport type PiSendAcknowledgement =\n\t| { id: string; task: string; inbox: string; outcome: \"dispatched\" }\n\t| { error: string; task?: string; outcome?: \"rejected-busy\" };\n// pi-herdr-agents extension\nexport type PiStopAcknowledgement =\n\t| { id: string; name: string; status: \"stop_requested\" | \"stop_pending\" }\n\t| { error: string; id?: string; name?: string };\n\n/** Narrow I/O for the existing host persistent policy, not a task scheduler. */\n// pi-herdr-agents extension\nexport interface PiPersistentIO {\n\t/** Raw events only; cursor indexes this array before generation filtering. */\n\treadEvents(record: PiRunRecord): PiPersistentEvent[];\n\tinspectWorktree(record: PiRunRecord): Promise<PiWorktreeHandoff | undefined>;\n\t/** Explicit lazy read, once per drain with eligible post-cursor events. */\n\treadLedger(record: PiRunRecord): PiLedgerEntry[];\n\t/** Transcript read only for an undelivered task-done, never help/quiet wakes. */\n\treadTaskSummary(record: PiRunRecord): AttributedSummary;\n\trejectBusy(record: PiRunRecord, task: string): void;\n\tdispatch(record: PiRunRecord, task: string, text: string): string;\n\trequestStop(record: PiRunRecord): void;\n\tacknowledge(record: PiRunRecord, event: PiPersistentEvent): PiLedgerEntry;\n\trecordStopped(record: PiRunRecord): void;\n}\n/** Run-scoped settlement I/O; only resumed acquisitions supply the late reader. */\n// pi-herdr-agents extension\nexport interface PiSettlementIO extends PiPersistentIO {\n\treadResumeResult?(): AttributedSummary & { sessionFile: string };\n}\n// pi-herdr-agents extension\nexport interface PiPersistentHostOperations {\n\tsend(\n\t\trecord: PiRunRecord,\n\t\ttext: string,\n\t\tio: PiPersistentIO,\n\t): PiSendAcknowledgement;\n\tstop(\n\t\trecord: PiRunRecord,\n\t\ttimeoutMs: number,\n\t\tio: PiPersistentIO,\n\t): PiStopAcknowledgement;\n\tdrain(record: PiRunRecord, io: PiPersistentIO): void;\n}\n\n// pi-herdr-agents extension\nexport interface PiProgressEvidence {\n\tupdatedAt?: number;\n\tclassification: \"blocked-tool\" | \"truncated-turn\" | \"generic-no-progress\";\n\tlastEntryKind: \"assistant\" | \"tool-result\" | \"message\" | \"other\" | \"none\";\n}\n// pi-herdr-agents extension\nexport interface PiRunSessionHooks {\n\tonSpawned?(\n\t\trecord: PiRunRecord,\n\t\tstarted: PiStartedMetadata,\n\t\ttask: Task,\n\t): void | Promise<void>;\n\tonObserved?(record: PiRunRecord, observation: RunObservation): void;\n\tonSettled(\n\t\trecord: PiRunRecord,\n\t\tresult: PiCompletedMetadata,\n\t\ttask: Task,\n\t\tio: PiSettlementIO,\n\t): void | DeliveryDecision | Promise<void | DeliveryDecision>;\n}\n// pi-herdr-agents extension\nexport interface PiRunSessionInfrastructure {\n\tsurfaceProvider: SurfaceProvider;\n\tlaunchOperations: PiLaunchOperations;\n\tworktreeOperations?: WorktreeOperations;\n\tsupervision: SupervisionCoordinator;\n\t/** Kernel process-identity probe for worktree cancel; tests inject it. */\n\tprocessProbe?: ProcessIdentityProbe;\n\t/** The parent accept re-check's command runner; tests inject it. */\n\tacceptRunner?: AcceptRunner;\n\t/** Sidebar marker transport; no ambient discovery when injected. */\n\tmarkerWriter?: MarkerWriter;\n\t/** Sidebar marker session evidence; no ambient discovery when injected. */\n\tmarkerSessionReader?: MarkerSessionReader;\n}\n// pi-herdr-agents extension\nexport interface DefaultRunSessionOptions {\n\t/**\n\t * The terminal host's provider and marker composition. Required unless\n\t * `infrastructure` supplies the closed test composition.\n\t */\n\thostSurface?: HostSurfaceBinding;\n\t/** Child reporter extension each launch loads; defaults to the protocol-only entry. */\n\tchildEntryPath?: string;\n\t/** Test injection consumes the actual Stage 3 seams, not replacement launch logic. */\n\tinfrastructure?: PiRunSessionInfrastructure;\n\tconfigDir: string;\n\tconfigExamplePath: string;\n\t/** Synchronous fresh snapshot, captured once at each launch/resume call. */\n\tgetLaunchSnapshot(): PiLaunchSnapshot;\n\troles: Role[];\n\thooks: PiRunSessionHooks;\n\tpersistent: PiPersistentHostOperations;\n\tforcePolling: boolean;\n\t/** Append one outcome-ledger line per model attempt. Default true. */\n\toutcomeLedger?: boolean;\n\t/** Host platform for the Windows support scope; tests inject win32. */\n\tplatform?: NodeJS.Platform;\n}\n// pi-herdr-agents extension\nexport interface PiWorktreeHandoffInput {\n\tname: string;\n\ttask: string;\n\tbranch: string;\n\tleafId: string;\n\tsnapshot: PiLaunchSnapshot;\n\truntimePlan: ResolvedRuntimePlan;\n}\n\n// pi-herdr-agents extension\nexport interface PiRunSession extends RunSession {\n\thandoffWorktree(\n\t\tinput: PiWorktreeHandoffInput,\n\t): Promise<{ record: PiRunRecord; focusError?: string }>;\n\tcreateWorktreeCleanupOperations(input: {\n\t\tmanifestDir: string;\n\t\tliveHolders: () => { path: string; persistent?: boolean }[];\n\t\tmanagedRoot?: string;\n\t}): WorktreeCleanupOperations;\n\tspawnPi(input: PiLaunchInput): Promise<AgentHandle>;\n\t/** Why this host refuses every managed-worktree operation, if it does. */\n\tmanagedWorktreeRefusal(): string | undefined;\n\tresumePi(input: PiResumeInput): Promise<AgentHandle>;\n\t/** Live-run metadata queries; all undefined after terminal retirement. */\n\tgetRecord(taskId: string): PiRunRecord | undefined;\n\tgetStarted(taskId: string): PiStartedMetadata | undefined;\n\tgetCompleted(taskId: string): PiCompletedMetadata | undefined;\n\t/** Live public Pi run ID -> control Task ID; undefined after retirement, not inbox ID. */\n\tgetControlTaskId(publicRunId: string): string | undefined;\n\tavailability(): { available: boolean; setupHint: string };\n\tlistWorktreeSurfaces(options?: {\n\t\tcwd?: string;\n\t\ttimeoutMs?: number;\n\t}): Promise<WorktreeSurfaceInfo[]>;\n\tsendPersistent(taskId: string, text: string): Promise<PiSendAcknowledgement>;\n\tstopPersistent(\n\t\ttaskId: string,\n\t\ttimeoutMs?: number,\n\t): Promise<PiStopAcknowledgement>;\n\tinspectProgress(taskId: string): PiProgressEvidence;\n\tdiagnostics(): {\n\t\tmode: \"wake+batch\" | \"polling(forced)\" | \"polling(fallback)\";\n\t\twatcherCount: number;\n\t};\n\tshutdown(\n\t\treason: \"reload\" | \"new\" | \"resume\" | \"fork\" | \"quit\" | undefined,\n\t): Promise<void>;\n}\n"]}
@@ -0,0 +1,12 @@
1
+ import type { SubagentLifecycle, ActivityReadResult } from "../core/types.ts";
2
+ import { type RunObservation } from "./run-session.ts";
3
+ import type { DefaultRunSessionOptions, PiRunSession } from "./pi-run-session-types.ts";
4
+ export declare function observePiActivity(input: {
5
+ id: string;
6
+ activityFile?: string;
7
+ lifecycle: SubagentLifecycle;
8
+ }, observedAt: number): RunObservation & {
9
+ activityRead: ActivityReadResult;
10
+ };
11
+ export declare function createDefaultRunSession(options: DefaultRunSessionOptions, previous?: PiRunSession): PiRunSession;
12
+ //# sourceMappingURL=pi-run-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-run-session.d.ts","sourceRoot":"","sources":["../../../maestro/runtime/pi-run-session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAIX,iBAAiB,EACjB,kBAAkB,EAElB,MAAM,kBAAkB,CAAC;AAqD1B,OAAO,EAGN,KAAK,cAAc,EAGnB,MAAM,kBAAkB,CAAC;AAa1B,OAAO,KAAK,EACX,wBAAwB,EAMxB,YAAY,EAKZ,MAAM,2BAA2B,CAAC;AAGnC,wBAAgB,iBAAiB,CAChC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,EAC1E,UAAU,EAAE,MAAM,GAChB,cAAc,GAAG;IAAE,YAAY,EAAE,kBAAkB,CAAA;CAAE,CAavD;AA+FD,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,wBAAwB,EACjC,QAAQ,CAAC,EAAE,YAAY,GACrB,YAAY,CAw1Bd"}