@nubl/maestro 0.0.1 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/README.md +56 -2
  2. package/dist/config.json.example +30 -0
  3. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
  4. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
  5. package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
  6. package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
  7. package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
  8. package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
  9. package/dist/maestro/adapters/pi/accept-groups.js +70 -0
  10. package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
  11. package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
  12. package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
  13. package/dist/maestro/adapters/pi/accept-runner.js +161 -0
  14. package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
  15. package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
  16. package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
  17. package/dist/maestro/adapters/pi/activity-file.js +454 -0
  18. package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
  19. package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
  20. package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
  21. package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
  22. package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
  23. package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
  24. package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
  25. package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
  26. package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
  27. package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
  28. package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
  29. package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
  30. package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
  31. package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
  32. package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
  33. package/dist/maestro/adapters/pi/child/entry.js +3 -0
  34. package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
  35. package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
  36. package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
  37. package/dist/maestro/adapters/pi/child/protocol.js +510 -0
  38. package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
  39. package/dist/maestro/adapters/pi/completion.d.ts +45 -0
  40. package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
  41. package/dist/maestro/adapters/pi/completion.js +295 -0
  42. package/dist/maestro/adapters/pi/completion.js.map +1 -0
  43. package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
  44. package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
  45. package/dist/maestro/adapters/pi/launch-command.js +75 -0
  46. package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
  47. package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
  48. package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
  49. package/dist/maestro/adapters/pi/launch-operations.js +270 -0
  50. package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
  51. package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
  52. package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
  53. package/dist/maestro/adapters/pi/launch-resume.js +183 -0
  54. package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
  55. package/dist/maestro/adapters/pi/launch.d.ts +148 -0
  56. package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
  57. package/dist/maestro/adapters/pi/launch.js +655 -0
  58. package/dist/maestro/adapters/pi/launch.js.map +1 -0
  59. package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
  60. package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
  61. package/dist/maestro/adapters/pi/model-registry.js +29 -0
  62. package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
  63. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
  64. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
  65. package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
  66. package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
  67. package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
  68. package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
  69. package/dist/maestro/adapters/pi/process-identity.js +248 -0
  70. package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
  71. package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
  72. package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
  73. package/dist/maestro/adapters/pi/process-tree.js +69 -0
  74. package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
  75. package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
  76. package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
  77. package/dist/maestro/adapters/pi/script-shell.js +43 -0
  78. package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
  79. package/dist/maestro/adapters/pi/session.d.ts +207 -0
  80. package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
  81. package/dist/maestro/adapters/pi/session.js +714 -0
  82. package/dist/maestro/adapters/pi/session.js.map +1 -0
  83. package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
  84. package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
  85. package/dist/maestro/adapters/pi/task-model-init.js +47 -0
  86. package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
  87. package/dist/maestro/core/accept.d.ts +150 -0
  88. package/dist/maestro/core/accept.d.ts.map +1 -0
  89. package/dist/maestro/core/accept.js +243 -0
  90. package/dist/maestro/core/accept.js.map +1 -0
  91. package/dist/maestro/core/activity.d.ts +4 -0
  92. package/dist/maestro/core/activity.d.ts.map +1 -0
  93. package/dist/maestro/core/activity.js +18 -0
  94. package/dist/maestro/core/activity.js.map +1 -0
  95. package/dist/maestro/core/child-busy.d.ts +14 -0
  96. package/dist/maestro/core/child-busy.d.ts.map +1 -0
  97. package/dist/maestro/core/child-busy.js +14 -0
  98. package/dist/maestro/core/child-busy.js.map +1 -0
  99. package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
  100. package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
  101. package/dist/maestro/core/config/guidelines-config.js +60 -0
  102. package/dist/maestro/core/config/guidelines-config.js.map +1 -0
  103. package/dist/maestro/core/config/herdr-config.d.ts +13 -0
  104. package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
  105. package/dist/maestro/core/config/herdr-config.js +65 -0
  106. package/dist/maestro/core/config/herdr-config.js.map +1 -0
  107. package/dist/maestro/core/config/model-config.d.ts +92 -0
  108. package/dist/maestro/core/config/model-config.d.ts.map +1 -0
  109. package/dist/maestro/core/config/model-config.js +522 -0
  110. package/dist/maestro/core/config/model-config.js.map +1 -0
  111. package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
  112. package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
  113. package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
  114. package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
  115. package/dist/maestro/core/config/pane-config.d.ts +15 -0
  116. package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
  117. package/dist/maestro/core/config/pane-config.js +101 -0
  118. package/dist/maestro/core/config/pane-config.js.map +1 -0
  119. package/dist/maestro/core/config/persistent-config.d.ts +7 -0
  120. package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
  121. package/dist/maestro/core/config/persistent-config.js +72 -0
  122. package/dist/maestro/core/config/persistent-config.js.map +1 -0
  123. package/dist/maestro/core/config/role-config.d.ts +7 -0
  124. package/dist/maestro/core/config/role-config.d.ts.map +1 -0
  125. package/dist/maestro/core/config/role-config.js +74 -0
  126. package/dist/maestro/core/config/role-config.js.map +1 -0
  127. package/dist/maestro/core/config/spawning-config.d.ts +7 -0
  128. package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
  129. package/dist/maestro/core/config/spawning-config.js +65 -0
  130. package/dist/maestro/core/config/spawning-config.js.map +1 -0
  131. package/dist/maestro/core/config/supervision-config.d.ts +7 -0
  132. package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
  133. package/dist/maestro/core/config/supervision-config.js +69 -0
  134. package/dist/maestro/core/config/supervision-config.js.map +1 -0
  135. package/dist/maestro/core/config/task-model-init.d.ts +118 -0
  136. package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
  137. package/dist/maestro/core/config/task-model-init.js +168 -0
  138. package/dist/maestro/core/config/task-model-init.js.map +1 -0
  139. package/dist/maestro/core/config/task-model-types.d.ts +36 -0
  140. package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
  141. package/dist/maestro/core/config/task-model-types.js +17 -0
  142. package/dist/maestro/core/config/task-model-types.js.map +1 -0
  143. package/dist/maestro/core/config/type-guards.d.ts +22 -0
  144. package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
  145. package/dist/maestro/core/config/type-guards.js +31 -0
  146. package/dist/maestro/core/config/type-guards.js.map +1 -0
  147. package/dist/maestro/core/deadline.d.ts +11 -0
  148. package/dist/maestro/core/deadline.d.ts.map +1 -0
  149. package/dist/maestro/core/deadline.js +30 -0
  150. package/dist/maestro/core/deadline.js.map +1 -0
  151. package/dist/maestro/core/declared-skills.d.ts +16 -0
  152. package/dist/maestro/core/declared-skills.d.ts.map +1 -0
  153. package/dist/maestro/core/declared-skills.js +52 -0
  154. package/dist/maestro/core/declared-skills.js.map +1 -0
  155. package/dist/maestro/core/delegation-depth.d.ts +38 -0
  156. package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
  157. package/dist/maestro/core/delegation-depth.js +59 -0
  158. package/dist/maestro/core/delegation-depth.js.map +1 -0
  159. package/dist/maestro/core/git-environment.d.ts +3 -0
  160. package/dist/maestro/core/git-environment.d.ts.map +1 -0
  161. package/dist/maestro/core/git-environment.js +29 -0
  162. package/dist/maestro/core/git-environment.js.map +1 -0
  163. package/dist/maestro/core/harness-adapter.d.ts +89 -0
  164. package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
  165. package/dist/maestro/core/harness-adapter.js +2 -0
  166. package/dist/maestro/core/harness-adapter.js.map +1 -0
  167. package/dist/maestro/core/host-text.d.ts +49 -0
  168. package/dist/maestro/core/host-text.d.ts.map +1 -0
  169. package/dist/maestro/core/host-text.js +106 -0
  170. package/dist/maestro/core/host-text.js.map +1 -0
  171. package/dist/maestro/core/index.d.ts +4 -0
  172. package/dist/maestro/core/index.d.ts.map +1 -0
  173. package/dist/maestro/core/index.js +2 -0
  174. package/dist/maestro/core/index.js.map +1 -0
  175. package/dist/maestro/core/lifecycle.d.ts +16 -0
  176. package/dist/maestro/core/lifecycle.d.ts.map +1 -0
  177. package/dist/maestro/core/lifecycle.js +429 -0
  178. package/dist/maestro/core/lifecycle.js.map +1 -0
  179. package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
  180. package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
  181. package/dist/maestro/core/opened-primary-workspace.js +49 -0
  182. package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
  183. package/dist/maestro/core/platform-support.d.ts +15 -0
  184. package/dist/maestro/core/platform-support.d.ts.map +1 -0
  185. package/dist/maestro/core/platform-support.js +23 -0
  186. package/dist/maestro/core/platform-support.js.map +1 -0
  187. package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
  188. package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
  189. package/dist/maestro/core/realpath-without-opening.js +45 -0
  190. package/dist/maestro/core/realpath-without-opening.js.map +1 -0
  191. package/dist/maestro/core/roles/discovery.d.ts +64 -0
  192. package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
  193. package/dist/maestro/core/roles/discovery.js +422 -0
  194. package/dist/maestro/core/roles/discovery.js.map +1 -0
  195. package/dist/maestro/core/routing.d.ts +115 -0
  196. package/dist/maestro/core/routing.d.ts.map +1 -0
  197. package/dist/maestro/core/routing.js +449 -0
  198. package/dist/maestro/core/routing.js.map +1 -0
  199. package/dist/maestro/core/script-launch.d.ts +47 -0
  200. package/dist/maestro/core/script-launch.d.ts.map +1 -0
  201. package/dist/maestro/core/script-launch.js +102 -0
  202. package/dist/maestro/core/script-launch.js.map +1 -0
  203. package/dist/maestro/core/shell.d.ts +2 -0
  204. package/dist/maestro/core/shell.d.ts.map +1 -0
  205. package/dist/maestro/core/shell.js +4 -0
  206. package/dist/maestro/core/shell.js.map +1 -0
  207. package/dist/maestro/core/specialist-notice.d.ts +36 -0
  208. package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
  209. package/dist/maestro/core/specialist-notice.js +41 -0
  210. package/dist/maestro/core/specialist-notice.js.map +1 -0
  211. package/dist/maestro/core/status.d.ts +87 -0
  212. package/dist/maestro/core/status.d.ts.map +1 -0
  213. package/dist/maestro/core/status.js +369 -0
  214. package/dist/maestro/core/status.js.map +1 -0
  215. package/dist/maestro/core/supervision.d.ts +56 -0
  216. package/dist/maestro/core/supervision.d.ts.map +1 -0
  217. package/dist/maestro/core/supervision.js +249 -0
  218. package/dist/maestro/core/supervision.js.map +1 -0
  219. package/dist/maestro/core/surface-provider.d.ts +200 -0
  220. package/dist/maestro/core/surface-provider.d.ts.map +1 -0
  221. package/dist/maestro/core/surface-provider.js +71 -0
  222. package/dist/maestro/core/surface-provider.js.map +1 -0
  223. package/dist/maestro/core/types.d.ts +388 -0
  224. package/dist/maestro/core/types.d.ts.map +1 -0
  225. package/dist/maestro/core/types.js +2 -0
  226. package/dist/maestro/core/types.js.map +1 -0
  227. package/dist/maestro/core/undelivered-children.d.ts +27 -0
  228. package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
  229. package/dist/maestro/core/undelivered-children.js +31 -0
  230. package/dist/maestro/core/undelivered-children.js.map +1 -0
  231. package/dist/maestro/core/wake.d.ts +32 -0
  232. package/dist/maestro/core/wake.d.ts.map +1 -0
  233. package/dist/maestro/core/wake.js +125 -0
  234. package/dist/maestro/core/wake.js.map +1 -0
  235. package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
  236. package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
  237. package/dist/maestro/core/worktree-cleanup.js +278 -0
  238. package/dist/maestro/core/worktree-cleanup.js.map +1 -0
  239. package/dist/maestro/core/worktree.d.ts +50 -0
  240. package/dist/maestro/core/worktree.d.ts.map +1 -0
  241. package/dist/maestro/core/worktree.js +23 -0
  242. package/dist/maestro/core/worktree.js.map +1 -0
  243. package/dist/maestro/engine.d.ts +5 -0
  244. package/dist/maestro/engine.d.ts.map +1 -0
  245. package/dist/maestro/engine.js +5 -0
  246. package/dist/maestro/engine.js.map +1 -0
  247. package/dist/maestro/pi/child.d.ts +8 -0
  248. package/dist/maestro/pi/child.d.ts.map +1 -0
  249. package/dist/maestro/pi/child.js +8 -0
  250. package/dist/maestro/pi/child.js.map +1 -0
  251. package/dist/maestro/pi/extension.d.ts +10 -0
  252. package/dist/maestro/pi/extension.d.ts.map +1 -0
  253. package/dist/maestro/pi/extension.js +8 -0
  254. package/dist/maestro/pi/extension.js.map +1 -0
  255. package/dist/maestro/pi/subagents-index.d.ts +9 -0
  256. package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
  257. package/dist/maestro/pi/subagents-index.js +9 -0
  258. package/dist/maestro/pi/subagents-index.js.map +1 -0
  259. package/dist/maestro/pi.d.ts +9 -0
  260. package/dist/maestro/pi.d.ts.map +1 -0
  261. package/dist/maestro/pi.js +7 -0
  262. package/dist/maestro/pi.js.map +1 -0
  263. package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
  264. package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
  265. package/dist/maestro/runtime/accept-recheck.js +92 -0
  266. package/dist/maestro/runtime/accept-recheck.js.map +1 -0
  267. package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
  268. package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
  269. package/dist/maestro/runtime/delegated-marker.js +200 -0
  270. package/dist/maestro/runtime/delegated-marker.js.map +1 -0
  271. package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
  272. package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
  273. package/dist/maestro/runtime/host-surface-binding.js +2 -0
  274. package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
  275. package/dist/maestro/runtime/index.d.ts +10 -0
  276. package/dist/maestro/runtime/index.d.ts.map +1 -0
  277. package/dist/maestro/runtime/index.js +6 -0
  278. package/dist/maestro/runtime/index.js.map +1 -0
  279. package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
  280. package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
  281. package/dist/maestro/runtime/pi-persistent-io.js +64 -0
  282. package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
  283. package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
  284. package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
  285. package/dist/maestro/runtime/pi-run-session-types.js +2 -0
  286. package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
  287. package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
  288. package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
  289. package/dist/maestro/runtime/pi-run-session.js +809 -0
  290. package/dist/maestro/runtime/pi-run-session.js.map +1 -0
  291. package/dist/maestro/runtime/run-session.d.ts +129 -0
  292. package/dist/maestro/runtime/run-session.d.ts.map +1 -0
  293. package/dist/maestro/runtime/run-session.js +680 -0
  294. package/dist/maestro/runtime/run-session.js.map +1 -0
  295. package/dist/maestro/runtime/surface-retention.d.ts +3 -0
  296. package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
  297. package/dist/maestro/runtime/surface-retention.js +5 -0
  298. package/dist/maestro/runtime/surface-retention.js.map +1 -0
  299. package/dist/maestro/runtime/task-model-init.d.ts +34 -0
  300. package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
  301. package/dist/maestro/runtime/task-model-init.js +78 -0
  302. package/dist/maestro/runtime/task-model-init.js.map +1 -0
  303. package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
  304. package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
  305. package/dist/maestro/runtime/worktree-operations.js +633 -0
  306. package/dist/maestro/runtime/worktree-operations.js.map +1 -0
  307. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
  308. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
  309. package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
  310. package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
  311. package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
  312. package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
  313. package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
  314. package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
  315. package/dist/maestro/testing/index.d.ts +5 -0
  316. package/dist/maestro/testing/index.d.ts.map +1 -0
  317. package/dist/maestro/testing/index.js +5 -0
  318. package/dist/maestro/testing/index.js.map +1 -0
  319. package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
  320. package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
  321. package/dist/maestro/testing/surface-provider.conformance.js +167 -0
  322. package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
  323. package/dist/pi-extension/subagents/catalog.d.ts +70 -0
  324. package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
  325. package/dist/pi-extension/subagents/catalog.js +231 -0
  326. package/dist/pi-extension/subagents/catalog.js.map +1 -0
  327. package/dist/pi-extension/subagents/config-path.d.ts +6 -0
  328. package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
  329. package/dist/pi-extension/subagents/config-path.js +21 -0
  330. package/dist/pi-extension/subagents/config-path.js.map +1 -0
  331. package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
  332. package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
  333. package/dist/pi-extension/subagents/control-tools.js +150 -0
  334. package/dist/pi-extension/subagents/control-tools.js.map +1 -0
  335. package/dist/pi-extension/subagents/controls.d.ts +52 -0
  336. package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
  337. package/dist/pi-extension/subagents/controls.js +173 -0
  338. package/dist/pi-extension/subagents/controls.js.map +1 -0
  339. package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
  340. package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
  341. package/dist/pi-extension/subagents/deferred-tools.js +67 -0
  342. package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
  343. package/dist/pi-extension/subagents/delivery.d.ts +22 -0
  344. package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
  345. package/dist/pi-extension/subagents/delivery.js +365 -0
  346. package/dist/pi-extension/subagents/delivery.js.map +1 -0
  347. package/dist/pi-extension/subagents/extension.d.ts +100 -0
  348. package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
  349. package/dist/pi-extension/subagents/extension.js +367 -0
  350. package/dist/pi-extension/subagents/extension.js.map +1 -0
  351. package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
  352. package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
  353. package/dist/pi-extension/subagents/launch-tools.js +373 -0
  354. package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
  355. package/dist/pi-extension/subagents/launch.d.ts +86 -0
  356. package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
  357. package/dist/pi-extension/subagents/launch.js +133 -0
  358. package/dist/pi-extension/subagents/launch.js.map +1 -0
  359. package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
  360. package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
  361. package/dist/pi-extension/subagents/model-registry.js +52 -0
  362. package/dist/pi-extension/subagents/model-registry.js.map +1 -0
  363. package/dist/pi-extension/subagents/observation.d.ts +38 -0
  364. package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
  365. package/dist/pi-extension/subagents/observation.js +168 -0
  366. package/dist/pi-extension/subagents/observation.js.map +1 -0
  367. package/dist/pi-extension/subagents/persistent.d.ts +72 -0
  368. package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
  369. package/dist/pi-extension/subagents/persistent.js +322 -0
  370. package/dist/pi-extension/subagents/persistent.js.map +1 -0
  371. package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
  372. package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
  373. package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
  374. package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
  375. package/dist/pi-extension/subagents/presentation.d.ts +149 -0
  376. package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
  377. package/dist/pi-extension/subagents/presentation.js +419 -0
  378. package/dist/pi-extension/subagents/presentation.js.map +1 -0
  379. package/dist/pi-extension/subagents/state.d.ts +183 -0
  380. package/dist/pi-extension/subagents/state.d.ts.map +1 -0
  381. package/dist/pi-extension/subagents/state.js +92 -0
  382. package/dist/pi-extension/subagents/state.js.map +1 -0
  383. package/dist/pi-extension/subagents/task-models.d.ts +9 -0
  384. package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
  385. package/dist/pi-extension/subagents/task-models.js +293 -0
  386. package/dist/pi-extension/subagents/task-models.js.map +1 -0
  387. package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
  388. package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
  389. package/dist/pi-extension/subagents/tool-boundary.js +53 -0
  390. package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
  391. package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
  392. package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
  393. package/dist/pi-extension/subagents/worktree-tools.js +185 -0
  394. package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
  395. package/dist/provenance.json +5 -0
  396. package/package.json +540 -27
  397. package/index.d.ts +0 -1
  398. package/index.js +0 -2
@@ -0,0 +1,680 @@
1
+ import { isAcquisitionUncertainError, } from "../core/surface-provider.js";
2
+ import { defaultRetainSurface } from "./surface-retention.js";
3
+ const ABORT_MESSAGE = "Aborted while waiting for subagent to finish";
4
+ const CANCELLED_BEFORE_LAUNCH = "Subagent was cancelled before launch.";
5
+ const UNCERTAIN_RETRY_INITIAL_MS = 1_000;
6
+ const UNCERTAIN_RETRY_MAX_MS = 30_000;
7
+ // pi-herdr-agents extension
8
+ export function createRunSession(options) {
9
+ const entries = new Map();
10
+ // Identity only, never a historical owner/result registry.
11
+ const consumed = new Set();
12
+ const sessionBase = options.sessionIdPrefix ?? Date.now().toString(36);
13
+ const retainSurface = options.retainSurface ?? defaultRetainSurface;
14
+ function reserve(task) {
15
+ if (entries.has(task.id) || consumed.has(task.id)) {
16
+ throw new Error(`Task ID "${task.id}" is already reserved or consumed.`);
17
+ }
18
+ const entry = {
19
+ task,
20
+ persistent: false,
21
+ nextCandidate: 0,
22
+ attempts: [],
23
+ controller: new AbortController(),
24
+ cancelIntent: new AbortController(),
25
+ suppressed: false,
26
+ released: false,
27
+ acquiring: false,
28
+ settled: false,
29
+ uncertainRetryDelayMs: UNCERTAIN_RETRY_INITIAL_MS,
30
+ };
31
+ entries.set(task.id, entry);
32
+ return entry;
33
+ }
34
+ function resolveRole(task) {
35
+ const role = options.roles.find((candidate) => candidate.name === task.role);
36
+ if (!role)
37
+ throw new Error(`Role "${task.role}" was not found.`);
38
+ return role;
39
+ }
40
+ function wrap(handle) {
41
+ const owner = { handle, adapter: options.adapter };
42
+ const surfaceId = handle.surfaceId;
43
+ const provider = options.surfaceProvider;
44
+ if (surfaceId !== undefined && provider) {
45
+ owner.closeTemporarySurface = async () => {
46
+ await provider.closeSurface(surfaceId);
47
+ };
48
+ }
49
+ return owner;
50
+ }
51
+ function defaultPreparation(task, role) {
52
+ return {
53
+ role,
54
+ persistent: task.behavior?.persistent ?? role.defaults?.persistent ?? false,
55
+ candidates: task.runtime
56
+ ? [
57
+ { model: task.runtime.model, thinking: task.runtime.thinking },
58
+ ...(task.runtime.fallbacks ?? []),
59
+ ]
60
+ : [],
61
+ spawnAttempt: async (spawnOptions, _index, cancelled) => wrap(await options.adapter.spawn({
62
+ ...spawnOptions,
63
+ acquisitionSignal: cancelled,
64
+ })),
65
+ };
66
+ }
67
+ function spawnOptions(entry, prepared, index) {
68
+ const task = entry.task;
69
+ const candidate = prepared.candidates[index];
70
+ return {
71
+ name: task.name,
72
+ task: task.prompt,
73
+ role: prepared.role,
74
+ cwd: task.cwd,
75
+ sessionId: `${sessionBase}-${task.id}`,
76
+ env: options.env || task.env ? { ...options.env, ...task.env } : undefined,
77
+ session: task.session,
78
+ behavior: task.behavior,
79
+ tools: task.tools,
80
+ systemPrompt: task.systemPrompt,
81
+ worktreeRequest: task.worktree,
82
+ runtime: candidate
83
+ ? { model: candidate.model, thinking: candidate.thinking }
84
+ : undefined,
85
+ };
86
+ }
87
+ function register(entry, owner) {
88
+ consumed.add(entry.task.id);
89
+ entry.attempts.push(owner);
90
+ entry.active = owner;
91
+ }
92
+ function retire(entry) {
93
+ if (entries.get(entry.task.id) === entry)
94
+ entries.delete(entry.task.id);
95
+ entry.active = undefined;
96
+ entry.prepared = undefined;
97
+ entry.attempts.length = 0;
98
+ entry.producer = undefined;
99
+ }
100
+ function release(entry, result) {
101
+ if (entry.released ||
102
+ entry.task.worktree ||
103
+ retainSurface(result, entry.task))
104
+ return;
105
+ entry.released = true;
106
+ for (const attempt of entry.attempts) {
107
+ const close = attempt.closeTemporarySurface;
108
+ if (!close)
109
+ continue;
110
+ // Only the close's own capture survives retirement. No close round-trip
111
+ // may delay process settlement or cause an unhandled rejection.
112
+ try {
113
+ void close.call(attempt).catch(() => { });
114
+ }
115
+ catch {
116
+ /* best effort */
117
+ }
118
+ }
119
+ }
120
+ function suppressedBeforeSupervision(entry) {
121
+ const owner = entry.active;
122
+ if (!owner)
123
+ return; // Pending acquisition still owns the reservation.
124
+ try {
125
+ release(entry, rejectedResult(owner.handle, new Error(ABORT_MESSAGE)));
126
+ }
127
+ finally {
128
+ retire(entry);
129
+ }
130
+ }
131
+ async function acquiredHook(entry, owner) {
132
+ // Acquisition is already registered. Hook failure is explicitly recoverable,
133
+ // not a launch failure and never an excuse to acquire another candidate.
134
+ await options.hooks?.onSpawned?.(owner.handle, entry.task);
135
+ }
136
+ async function acquireNext(entry) {
137
+ const prepared = entry.prepared;
138
+ if (!prepared)
139
+ throw new Error(`Task "${entry.task.id}" has no prepared launch.`);
140
+ const failures = [];
141
+ let uncertain;
142
+ const count = Math.max(1, prepared.candidates.length);
143
+ while (!entry.suppressed && !entry.cancel && entry.nextCandidate < count) {
144
+ const index = entry.nextCandidate++;
145
+ let owner;
146
+ entry.acquiring = true;
147
+ try {
148
+ owner = await prepared.spawnAttempt(spawnOptions(entry, prepared, index), index, entry.cancelIntent.signal);
149
+ }
150
+ catch (error) {
151
+ failures.push({
152
+ model: prepared.candidates[index]?.model ?? "adapter default",
153
+ error: errorText(error),
154
+ });
155
+ if (isAcquisitionUncertainError(error)) {
156
+ uncertain = error;
157
+ break;
158
+ }
159
+ continue;
160
+ }
161
+ finally {
162
+ entry.acquiring = false;
163
+ }
164
+ // Even a suppressed or cancelled in-flight acquisition must transfer its
165
+ // real owner; a cancelled one is terminated as soon as it is registered.
166
+ register(entry, owner);
167
+ terminateTransferred(entry);
168
+ return { owner, failures, uncertain: undefined };
169
+ }
170
+ return { owner: undefined, failures, uncertain };
171
+ }
172
+ function notifyCancel(entry, state, owner = entry.active) {
173
+ if (!owner)
174
+ return;
175
+ try {
176
+ options.hooks?.onCancelState?.(owner.handle, entry.task, state);
177
+ }
178
+ catch {
179
+ /* presentation only; never affects termination */
180
+ }
181
+ }
182
+ function terminateTransferred(entry) {
183
+ if (!entry.cancel)
184
+ return;
185
+ notifyCancel(entry, "requested");
186
+ void terminate(entry);
187
+ }
188
+ // One owned kill at a time. Only a resolved kill confirms termination; only
189
+ // then is the producer's wait aborted, so a failed kill leaves it supervised.
190
+ function terminate(entry) {
191
+ const state = entry.cancel;
192
+ const owner = entry.active;
193
+ if (!state || !owner || state.termination === "confirmed")
194
+ return Promise.resolve();
195
+ if (state.kill)
196
+ return state.kill;
197
+ const kill = (async () => {
198
+ try {
199
+ await owner.adapter.kill(owner.handle);
200
+ state.termination = "confirmed";
201
+ state.confirmedAt = Date.now();
202
+ state.error = undefined;
203
+ entry.uncertainRetryDelayMs = UNCERTAIN_RETRY_INITIAL_MS;
204
+ entry.controller.abort();
205
+ }
206
+ catch (error) {
207
+ state.termination = "unconfirmed";
208
+ state.error = errorText(error);
209
+ }
210
+ finally {
211
+ state.kill = undefined;
212
+ notifyCancel(entry, state.termination, owner);
213
+ wake(state);
214
+ }
215
+ })();
216
+ state.kill = kill;
217
+ return kill;
218
+ }
219
+ function wake(state) {
220
+ const waiters = [...state.waiters];
221
+ state.waiters.clear();
222
+ for (const resolve of waiters)
223
+ resolve();
224
+ }
225
+ // The producer settles a cancelled run only after confirmed termination. It
226
+ // makes one kill itself when its wait ended without one (late acquisition or
227
+ // natural exit evidence); otherwise it waits for an operator retry or shutdown.
228
+ async function confirmTermination(entry) {
229
+ const state = entry.cancel;
230
+ let attempted = false;
231
+ for (;;) {
232
+ if (state.termination === "confirmed" || entry.suppressed)
233
+ return;
234
+ if (state.kill)
235
+ await state.kill;
236
+ else if (!attempted) {
237
+ attempted = true;
238
+ await terminate(entry);
239
+ }
240
+ else
241
+ await new Promise((resolve) => state.waiters.add(resolve));
242
+ }
243
+ }
244
+ function refresh(entry, at) {
245
+ const owner = entry.active;
246
+ const observation = owner?.observe?.(at);
247
+ if (owner && observation)
248
+ options.hooks?.onObserved?.(owner.handle, observation.projection, observation);
249
+ return observation;
250
+ }
251
+ async function deliver(entry, result) {
252
+ try {
253
+ if (!entry.suppressed)
254
+ await options.hooks?.onSettled?.(result, entry.task);
255
+ release(entry, result);
256
+ return result;
257
+ }
258
+ finally {
259
+ // A rejected send retains panes but not full runtime ownership.
260
+ retire(entry);
261
+ }
262
+ }
263
+ function retryable(entry, owner, result) {
264
+ const prepared = entry.prepared;
265
+ return (!entry.suppressed &&
266
+ !owner.handle.launchFailure &&
267
+ !(owner.persistent ?? entry.persistent) &&
268
+ result.evidence?.errorMessage !== undefined &&
269
+ !!prepared &&
270
+ entry.nextCandidate < prepared.candidates.length);
271
+ }
272
+ function waitForUncertainRetry(entry) {
273
+ const signal = entry.controller.signal;
274
+ if (signal.aborted)
275
+ return Promise.resolve();
276
+ const delay = entry.uncertainRetryDelayMs;
277
+ entry.uncertainRetryDelayMs = Math.min(delay * 2, UNCERTAIN_RETRY_MAX_MS);
278
+ return new Promise((resolve) => {
279
+ const finish = () => {
280
+ clearTimeout(timer);
281
+ signal.removeEventListener("abort", finish);
282
+ resolve();
283
+ };
284
+ const timer = setTimeout(finish, delay);
285
+ signal.addEventListener("abort", finish, { once: true });
286
+ });
287
+ }
288
+ async function produce(entry) {
289
+ for (;;) {
290
+ const owner = entry.active;
291
+ if (!owner)
292
+ throw new Error(`Task "${entry.task.id}" has no active owner.`);
293
+ let result;
294
+ try {
295
+ const evidence = await owner.adapter.awaitCompletion(owner.handle, entry.controller.signal);
296
+ entry.uncertainRetryDelayMs = UNCERTAIN_RETRY_INITIAL_MS;
297
+ result = evidenceResult(owner.handle, evidence);
298
+ }
299
+ catch (error) {
300
+ if (entry.cancel &&
301
+ entry.cancel.termination !== "confirmed" &&
302
+ !entry.suppressed) {
303
+ await waitForUncertainRetry(entry);
304
+ if (!entry.controller.signal.aborted)
305
+ continue;
306
+ }
307
+ if (owner.handle.launchFailure && !entry.cancel && !entry.suppressed) {
308
+ // A broken watcher is not exit evidence for an uncertain launch.
309
+ // Retain this same owner and retry supervision, never acquisition.
310
+ try {
311
+ await owner.adapter.kill(owner.handle);
312
+ entry.uncertainRetryDelayMs = UNCERTAIN_RETRY_INITIAL_MS;
313
+ }
314
+ catch {
315
+ await waitForUncertainRetry(entry);
316
+ // Suppression or confirmed cancel ends the wait without another probe.
317
+ if (!entry.controller.signal.aborted)
318
+ continue;
319
+ }
320
+ }
321
+ result = rejectedResult(owner.handle, error);
322
+ }
323
+ // Settle point: intent recorded before this synchronous check wins, and a
324
+ // natural result that cannot start a fallback makes later cancels too late.
325
+ if (entry.cancel) {
326
+ await confirmTermination(entry);
327
+ result = cancelledResult(owner.handle, entry.cancel);
328
+ }
329
+ else if (!retryable(entry, owner, result))
330
+ entry.settled = true;
331
+ let reopened = false;
332
+ let interruption;
333
+ const control = {
334
+ async cancellable(work) {
335
+ // Only a natural result that already took the settle point reopens it.
336
+ if (!entry.settled || entry.cancel || entry.suppressed)
337
+ return work(entry.controller.signal);
338
+ reopened = true;
339
+ entry.settled = false;
340
+ try {
341
+ return await work(entry.controller.signal);
342
+ }
343
+ finally {
344
+ if (!entry.cancel)
345
+ entry.settled = true;
346
+ // A cancel recorded in the window wins once termination is
347
+ // confirmed, even if the work finished on its own (ADR-0017).
348
+ else if (!entry.suppressed)
349
+ await confirmTermination(entry);
350
+ if (entry.suppressed)
351
+ interruption = "suppressed";
352
+ else if (entry.cancel)
353
+ interruption = "cancelled";
354
+ }
355
+ },
356
+ interruption: () => interruption,
357
+ };
358
+ try {
359
+ if (owner.finalize)
360
+ result = await owner.finalize(result, entry.task, control);
361
+ }
362
+ catch (error) {
363
+ retire(entry);
364
+ throw error;
365
+ }
366
+ if (reopened && entry.cancel && !entry.suppressed) {
367
+ // Cancel intent recorded during the reopened window wins (ADR-0014).
368
+ await confirmTermination(entry);
369
+ result = cancelledResult(owner.handle, entry.cancel);
370
+ }
371
+ // A cancel recorded while finalizing a retryable error lands below: the
372
+ // acquisition gate starts nothing and the settled owner is terminated.
373
+ if (retryable(entry, owner, result)) {
374
+ entry.settled = false;
375
+ const next = await acquireNext(entry);
376
+ if (next.owner && !entry.suppressed) {
377
+ try {
378
+ await acquiredHook(entry, next.owner);
379
+ }
380
+ catch (error) {
381
+ if (!entry.suppressed && !entry.cancel)
382
+ throw error;
383
+ }
384
+ // A cancelled transferred owner is already being terminated; its
385
+ // own wait and finalization produce the single cancelled result.
386
+ if (!entry.suppressed)
387
+ continue;
388
+ }
389
+ if (entry.cancel && !entry.suppressed) {
390
+ // Cancelled before or while acquiring and nothing was transferred: the
391
+ // settled previous attempt is still owned; terminate it, then deliver.
392
+ await confirmTermination(entry);
393
+ return deliver(entry, cancelledResult(owner.handle, entry.cancel));
394
+ }
395
+ if (!entry.suppressed && next.failures.length && result.evidence) {
396
+ const message = `${result.evidence.errorMessage}\n\nFallback launch failures: ${formatFailures(next.failures)}`;
397
+ result = {
398
+ ...result,
399
+ error: message,
400
+ evidence: { ...result.evidence, errorMessage: message },
401
+ };
402
+ }
403
+ // Every fallback failed: this natural failure is now terminal, so a
404
+ // cancel during its delivery is too late, never a second outcome.
405
+ entry.settled = true;
406
+ }
407
+ return deliver(entry, result);
408
+ }
409
+ }
410
+ function active(taskId) {
411
+ const owner = entries.get(taskId)?.active;
412
+ if (!owner)
413
+ throw new Error(`Task "${taskId}" has no active owner${consumed.has(taskId) ? " (retired/consumed)" : ""}.`);
414
+ return owner;
415
+ }
416
+ return {
417
+ async spawn(task, preparedOverride) {
418
+ const entry = reserve(task);
419
+ try {
420
+ const prepared = preparedOverride ??
421
+ (options.operations
422
+ ? await options.operations.prepare(task, resolveRole(task))
423
+ : defaultPreparation(task, resolveRole(task)));
424
+ if (entry.suppressed)
425
+ throw new Error(ABORT_MESSAGE);
426
+ if (entry.cancel)
427
+ throw new Error(CANCELLED_BEFORE_LAUNCH);
428
+ if (task.worktree && prepared.candidates.length > 1) {
429
+ throw new Error("Model fallbacks are not supported for worktree subagents.");
430
+ }
431
+ entry.prepared = prepared;
432
+ entry.persistent = prepared.persistent;
433
+ const acquired = await acquireNext(entry);
434
+ if (entry.suppressed) {
435
+ suppressedBeforeSupervision(entry);
436
+ throw new Error(ABORT_MESSAGE);
437
+ }
438
+ if (!acquired.owner) {
439
+ if (acquired.uncertain)
440
+ throw acquired.uncertain;
441
+ if (entry.cancel)
442
+ throw new Error(CANCELLED_BEFORE_LAUNCH);
443
+ throw new Error(`Subagent could not launch with any configured model. Attempted: ${prepared.candidates.map((candidate) => candidate.model).join(", ")}. ${formatFailures(acquired.failures)}`);
444
+ }
445
+ await acquiredHook(entry, acquired.owner);
446
+ if (entry.suppressed)
447
+ throw new Error(ABORT_MESSAGE);
448
+ return acquired.owner.handle;
449
+ }
450
+ catch (error) {
451
+ if (!consumed.has(task.id))
452
+ retire(entry);
453
+ throw error;
454
+ }
455
+ },
456
+ async resume({ task, ...resumeOptions }) {
457
+ const entry = reserve(task);
458
+ try {
459
+ entry.persistent =
460
+ task.behavior?.persistent ??
461
+ options.roles.find((role) => role.name === task.role)?.defaults
462
+ ?.persistent ??
463
+ false;
464
+ entry.acquiring = true;
465
+ resumeOptions.acquisitionSignal = entry.cancelIntent.signal;
466
+ let owner;
467
+ try {
468
+ owner = options.operations?.resume
469
+ ? await options.operations.resume(resumeOptions, task)
470
+ : wrap(await options.adapter.resume(resumeOptions));
471
+ }
472
+ finally {
473
+ entry.acquiring = false;
474
+ }
475
+ register(entry, owner);
476
+ terminateTransferred(entry);
477
+ if (entry.suppressed) {
478
+ suppressedBeforeSupervision(entry);
479
+ throw new Error(ABORT_MESSAGE);
480
+ }
481
+ await acquiredHook(entry, owner);
482
+ if (entry.suppressed)
483
+ throw new Error(ABORT_MESSAGE);
484
+ return owner.handle;
485
+ }
486
+ catch (error) {
487
+ if (!consumed.has(task.id))
488
+ retire(entry);
489
+ throw error;
490
+ }
491
+ },
492
+ async supervise(handle, task, signal) {
493
+ const entry = entries.get(task.id);
494
+ if (!entry)
495
+ throw new Error(`Task "${task.id}" ${consumed.has(task.id) ? "is retired/consumed" : "was not found"}.`);
496
+ if (entry.task !== task || entry.active?.handle !== handle) {
497
+ throw new Error(`Task "${task.id}" does not match this active handle/owner.`);
498
+ }
499
+ if (signal?.aborted)
500
+ throw new Error(ABORT_MESSAGE);
501
+ let producer = entry.producer;
502
+ if (!producer) {
503
+ // Publish and observe before either observation or adapter callbacks can
504
+ // suppress/retire the entry or synchronously rejoin this shared outcome.
505
+ let resolveProducer;
506
+ let rejectProducer;
507
+ producer = new Promise((resolve, reject) => {
508
+ resolveProducer = resolve;
509
+ rejectProducer = reject;
510
+ });
511
+ entry.producer = producer;
512
+ // Keep the owned producer observed even if startup throws or all callers cancel.
513
+ void producer
514
+ .catch(() => { })
515
+ .finally(() => {
516
+ if (entry.producer === producer)
517
+ entry.producer = undefined;
518
+ });
519
+ try {
520
+ refresh(entry, Date.now());
521
+ }
522
+ catch (error) {
523
+ // No adapter wait has started. Reject reentrant joins with the original
524
+ // error; only unsuppressed ownership remains explicitly recoverable.
525
+ entry.producer = undefined;
526
+ rejectProducer(error);
527
+ if (entry.suppressed) {
528
+ try {
529
+ suppressedBeforeSupervision(entry);
530
+ }
531
+ catch {
532
+ // Retention failure must not mask the callback error. The helper
533
+ // retires ownership in its finally even when release throws.
534
+ }
535
+ }
536
+ throw error;
537
+ }
538
+ // Start synchronously: microtask deferral changes evidence-vs-abort ordering.
539
+ void produce(entry).then(resolveProducer, rejectProducer);
540
+ }
541
+ else {
542
+ refresh(entry, Date.now());
543
+ }
544
+ // Callbacks may already have retired entry.producer; never reread that slot.
545
+ return join(producer, signal);
546
+ },
547
+ getHandle: (taskId) => entries.get(taskId)?.active?.handle,
548
+ getTask: (taskId) => entries.get(taskId)?.task,
549
+ async send(taskId, text) {
550
+ const owner = active(taskId);
551
+ await owner.adapter.sendInput(owner.handle, text);
552
+ },
553
+ async kill(taskId) {
554
+ const owner = active(taskId);
555
+ await owner.adapter.kill(owner.handle);
556
+ },
557
+ async interrupt(taskId) {
558
+ const owner = active(taskId);
559
+ await owner.adapter.interrupt(owner.handle);
560
+ },
561
+ observe(taskId, at = Date.now()) {
562
+ const entry = entries.get(taskId);
563
+ return entry ? refresh(entry, at) : undefined;
564
+ },
565
+ suppress(taskId) {
566
+ const entry = entries.get(taskId);
567
+ if (!entry || entry.suppressed)
568
+ return;
569
+ entry.suppressed = true;
570
+ entry.controller.abort();
571
+ if (entry.cancel)
572
+ wake(entry.cancel);
573
+ if (!entry.producer)
574
+ suppressedBeforeSupervision(entry);
575
+ },
576
+ async cancel(taskId) {
577
+ const entry = entries.get(taskId);
578
+ if (!entry) {
579
+ if (consumed.has(taskId))
580
+ return { status: "already-terminal" };
581
+ throw new Error(`Task "${taskId}" was not found.`);
582
+ }
583
+ if (entry.active?.persistent ?? entry.persistent)
584
+ throw new Error(`Task "${taskId}" is persistent; use its graceful stop instead of cancel.`);
585
+ if (entry.suppressed || (entry.settled && !entry.cancel))
586
+ return { status: "already-terminal" };
587
+ const repeated = !!entry.cancel;
588
+ // Terminal intent is recorded synchronously, before any abort, kill or await.
589
+ const state = (entry.cancel ??= {
590
+ requestedAt: Date.now(),
591
+ termination: "unconfirmed",
592
+ waiters: new Set(),
593
+ });
594
+ entry.cancelIntent.abort();
595
+ if (state.termination !== "confirmed")
596
+ notifyCancel(entry, "requested");
597
+ const report = (status) => {
598
+ const value = { status, requestedAt: state.requestedAt };
599
+ if (status === "unconfirmed" && state.error)
600
+ value.error = state.error;
601
+ if (repeated)
602
+ value.repeated = true;
603
+ return value;
604
+ };
605
+ // No owner yet: the in-flight acquisition transfers it, then it is killed.
606
+ if (!entry.active || entry.acquiring)
607
+ return report("requested");
608
+ await terminate(entry);
609
+ return report(state.termination);
610
+ },
611
+ };
612
+ }
613
+ function errorText(cause) {
614
+ return cause instanceof Error ? cause.message : String(cause);
615
+ }
616
+ function formatFailures(failures) {
617
+ return failures.map(({ model, error }) => `${model}: ${error}`).join("; ");
618
+ }
619
+ function evidenceResult(handle, evidence) {
620
+ return {
621
+ handle,
622
+ outcome: evidence.reason === "ping"
623
+ ? "help"
624
+ : evidence.reason === "error" || evidence.exitCode !== 0
625
+ ? "failed"
626
+ : "completed",
627
+ exitCode: evidence.exitCode,
628
+ error: evidence.errorMessage,
629
+ output: evidence.finalMessage?.text,
630
+ durationMs: Date.now() - handle.startedAt,
631
+ evidence,
632
+ };
633
+ }
634
+ function cancelledResult(handle, state) {
635
+ const cancellation = {
636
+ requestedAt: state.requestedAt,
637
+ termination: state.termination,
638
+ };
639
+ if (state.confirmedAt !== undefined)
640
+ cancellation.confirmedAt = state.confirmedAt;
641
+ if (state.error !== undefined)
642
+ cancellation.error = state.error;
643
+ return {
644
+ handle,
645
+ outcome: "killed",
646
+ error: "Cancelled by operator",
647
+ durationMs: Date.now() - handle.startedAt,
648
+ cancellation,
649
+ };
650
+ }
651
+ function rejectedResult(handle, cause) {
652
+ const message = errorText(cause);
653
+ return {
654
+ handle,
655
+ outcome: /abort/i.test(message) ? "killed" : "failed",
656
+ error: message,
657
+ durationMs: Date.now() - handle.startedAt,
658
+ };
659
+ }
660
+ function join(producer, signal) {
661
+ if (!signal)
662
+ return producer;
663
+ return new Promise((resolve, reject) => {
664
+ const onAbort = () => {
665
+ signal.removeEventListener("abort", onAbort);
666
+ reject(new Error(ABORT_MESSAGE));
667
+ };
668
+ signal.addEventListener("abort", onAbort, { once: true });
669
+ if (signal.aborted)
670
+ onAbort();
671
+ void producer.then((result) => {
672
+ signal.removeEventListener("abort", onAbort);
673
+ resolve(result);
674
+ }, (cause) => {
675
+ signal.removeEventListener("abort", onAbort);
676
+ reject(cause);
677
+ });
678
+ });
679
+ }
680
+ //# sourceMappingURL=run-session.js.map