@nubl/maestro 0.0.1 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/README.md +55 -2
  2. package/dist/config.json.example +30 -0
  3. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
  4. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
  5. package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
  6. package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
  7. package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
  8. package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
  9. package/dist/maestro/adapters/pi/accept-groups.js +70 -0
  10. package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
  11. package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
  12. package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
  13. package/dist/maestro/adapters/pi/accept-runner.js +161 -0
  14. package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
  15. package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
  16. package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
  17. package/dist/maestro/adapters/pi/activity-file.js +454 -0
  18. package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
  19. package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
  20. package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
  21. package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
  22. package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
  23. package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
  24. package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
  25. package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
  26. package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
  27. package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
  28. package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
  29. package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
  30. package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
  31. package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
  32. package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
  33. package/dist/maestro/adapters/pi/child/entry.js +3 -0
  34. package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
  35. package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
  36. package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
  37. package/dist/maestro/adapters/pi/child/protocol.js +510 -0
  38. package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
  39. package/dist/maestro/adapters/pi/completion.d.ts +45 -0
  40. package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
  41. package/dist/maestro/adapters/pi/completion.js +295 -0
  42. package/dist/maestro/adapters/pi/completion.js.map +1 -0
  43. package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
  44. package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
  45. package/dist/maestro/adapters/pi/launch-command.js +75 -0
  46. package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
  47. package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
  48. package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
  49. package/dist/maestro/adapters/pi/launch-operations.js +270 -0
  50. package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
  51. package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
  52. package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
  53. package/dist/maestro/adapters/pi/launch-resume.js +183 -0
  54. package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
  55. package/dist/maestro/adapters/pi/launch.d.ts +148 -0
  56. package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
  57. package/dist/maestro/adapters/pi/launch.js +655 -0
  58. package/dist/maestro/adapters/pi/launch.js.map +1 -0
  59. package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
  60. package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
  61. package/dist/maestro/adapters/pi/model-registry.js +29 -0
  62. package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
  63. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
  64. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
  65. package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
  66. package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
  67. package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
  68. package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
  69. package/dist/maestro/adapters/pi/process-identity.js +248 -0
  70. package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
  71. package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
  72. package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
  73. package/dist/maestro/adapters/pi/process-tree.js +69 -0
  74. package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
  75. package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
  76. package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
  77. package/dist/maestro/adapters/pi/script-shell.js +43 -0
  78. package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
  79. package/dist/maestro/adapters/pi/session.d.ts +207 -0
  80. package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
  81. package/dist/maestro/adapters/pi/session.js +714 -0
  82. package/dist/maestro/adapters/pi/session.js.map +1 -0
  83. package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
  84. package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
  85. package/dist/maestro/adapters/pi/task-model-init.js +47 -0
  86. package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
  87. package/dist/maestro/core/accept.d.ts +150 -0
  88. package/dist/maestro/core/accept.d.ts.map +1 -0
  89. package/dist/maestro/core/accept.js +243 -0
  90. package/dist/maestro/core/accept.js.map +1 -0
  91. package/dist/maestro/core/activity.d.ts +4 -0
  92. package/dist/maestro/core/activity.d.ts.map +1 -0
  93. package/dist/maestro/core/activity.js +18 -0
  94. package/dist/maestro/core/activity.js.map +1 -0
  95. package/dist/maestro/core/child-busy.d.ts +14 -0
  96. package/dist/maestro/core/child-busy.d.ts.map +1 -0
  97. package/dist/maestro/core/child-busy.js +14 -0
  98. package/dist/maestro/core/child-busy.js.map +1 -0
  99. package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
  100. package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
  101. package/dist/maestro/core/config/guidelines-config.js +60 -0
  102. package/dist/maestro/core/config/guidelines-config.js.map +1 -0
  103. package/dist/maestro/core/config/herdr-config.d.ts +13 -0
  104. package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
  105. package/dist/maestro/core/config/herdr-config.js +65 -0
  106. package/dist/maestro/core/config/herdr-config.js.map +1 -0
  107. package/dist/maestro/core/config/model-config.d.ts +92 -0
  108. package/dist/maestro/core/config/model-config.d.ts.map +1 -0
  109. package/dist/maestro/core/config/model-config.js +522 -0
  110. package/dist/maestro/core/config/model-config.js.map +1 -0
  111. package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
  112. package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
  113. package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
  114. package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
  115. package/dist/maestro/core/config/pane-config.d.ts +15 -0
  116. package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
  117. package/dist/maestro/core/config/pane-config.js +101 -0
  118. package/dist/maestro/core/config/pane-config.js.map +1 -0
  119. package/dist/maestro/core/config/persistent-config.d.ts +7 -0
  120. package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
  121. package/dist/maestro/core/config/persistent-config.js +72 -0
  122. package/dist/maestro/core/config/persistent-config.js.map +1 -0
  123. package/dist/maestro/core/config/role-config.d.ts +7 -0
  124. package/dist/maestro/core/config/role-config.d.ts.map +1 -0
  125. package/dist/maestro/core/config/role-config.js +74 -0
  126. package/dist/maestro/core/config/role-config.js.map +1 -0
  127. package/dist/maestro/core/config/spawning-config.d.ts +7 -0
  128. package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
  129. package/dist/maestro/core/config/spawning-config.js +65 -0
  130. package/dist/maestro/core/config/spawning-config.js.map +1 -0
  131. package/dist/maestro/core/config/supervision-config.d.ts +7 -0
  132. package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
  133. package/dist/maestro/core/config/supervision-config.js +69 -0
  134. package/dist/maestro/core/config/supervision-config.js.map +1 -0
  135. package/dist/maestro/core/config/task-model-init.d.ts +118 -0
  136. package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
  137. package/dist/maestro/core/config/task-model-init.js +168 -0
  138. package/dist/maestro/core/config/task-model-init.js.map +1 -0
  139. package/dist/maestro/core/config/task-model-types.d.ts +36 -0
  140. package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
  141. package/dist/maestro/core/config/task-model-types.js +17 -0
  142. package/dist/maestro/core/config/task-model-types.js.map +1 -0
  143. package/dist/maestro/core/config/type-guards.d.ts +22 -0
  144. package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
  145. package/dist/maestro/core/config/type-guards.js +31 -0
  146. package/dist/maestro/core/config/type-guards.js.map +1 -0
  147. package/dist/maestro/core/deadline.d.ts +11 -0
  148. package/dist/maestro/core/deadline.d.ts.map +1 -0
  149. package/dist/maestro/core/deadline.js +30 -0
  150. package/dist/maestro/core/deadline.js.map +1 -0
  151. package/dist/maestro/core/declared-skills.d.ts +16 -0
  152. package/dist/maestro/core/declared-skills.d.ts.map +1 -0
  153. package/dist/maestro/core/declared-skills.js +52 -0
  154. package/dist/maestro/core/declared-skills.js.map +1 -0
  155. package/dist/maestro/core/delegation-depth.d.ts +38 -0
  156. package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
  157. package/dist/maestro/core/delegation-depth.js +59 -0
  158. package/dist/maestro/core/delegation-depth.js.map +1 -0
  159. package/dist/maestro/core/git-environment.d.ts +3 -0
  160. package/dist/maestro/core/git-environment.d.ts.map +1 -0
  161. package/dist/maestro/core/git-environment.js +29 -0
  162. package/dist/maestro/core/git-environment.js.map +1 -0
  163. package/dist/maestro/core/harness-adapter.d.ts +89 -0
  164. package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
  165. package/dist/maestro/core/harness-adapter.js +2 -0
  166. package/dist/maestro/core/harness-adapter.js.map +1 -0
  167. package/dist/maestro/core/host-text.d.ts +49 -0
  168. package/dist/maestro/core/host-text.d.ts.map +1 -0
  169. package/dist/maestro/core/host-text.js +106 -0
  170. package/dist/maestro/core/host-text.js.map +1 -0
  171. package/dist/maestro/core/index.d.ts +4 -0
  172. package/dist/maestro/core/index.d.ts.map +1 -0
  173. package/dist/maestro/core/index.js +2 -0
  174. package/dist/maestro/core/index.js.map +1 -0
  175. package/dist/maestro/core/lifecycle.d.ts +16 -0
  176. package/dist/maestro/core/lifecycle.d.ts.map +1 -0
  177. package/dist/maestro/core/lifecycle.js +429 -0
  178. package/dist/maestro/core/lifecycle.js.map +1 -0
  179. package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
  180. package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
  181. package/dist/maestro/core/opened-primary-workspace.js +49 -0
  182. package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
  183. package/dist/maestro/core/platform-support.d.ts +15 -0
  184. package/dist/maestro/core/platform-support.d.ts.map +1 -0
  185. package/dist/maestro/core/platform-support.js +23 -0
  186. package/dist/maestro/core/platform-support.js.map +1 -0
  187. package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
  188. package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
  189. package/dist/maestro/core/realpath-without-opening.js +45 -0
  190. package/dist/maestro/core/realpath-without-opening.js.map +1 -0
  191. package/dist/maestro/core/roles/discovery.d.ts +64 -0
  192. package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
  193. package/dist/maestro/core/roles/discovery.js +422 -0
  194. package/dist/maestro/core/roles/discovery.js.map +1 -0
  195. package/dist/maestro/core/routing.d.ts +115 -0
  196. package/dist/maestro/core/routing.d.ts.map +1 -0
  197. package/dist/maestro/core/routing.js +449 -0
  198. package/dist/maestro/core/routing.js.map +1 -0
  199. package/dist/maestro/core/script-launch.d.ts +47 -0
  200. package/dist/maestro/core/script-launch.d.ts.map +1 -0
  201. package/dist/maestro/core/script-launch.js +102 -0
  202. package/dist/maestro/core/script-launch.js.map +1 -0
  203. package/dist/maestro/core/shell.d.ts +2 -0
  204. package/dist/maestro/core/shell.d.ts.map +1 -0
  205. package/dist/maestro/core/shell.js +4 -0
  206. package/dist/maestro/core/shell.js.map +1 -0
  207. package/dist/maestro/core/specialist-notice.d.ts +36 -0
  208. package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
  209. package/dist/maestro/core/specialist-notice.js +41 -0
  210. package/dist/maestro/core/specialist-notice.js.map +1 -0
  211. package/dist/maestro/core/status.d.ts +87 -0
  212. package/dist/maestro/core/status.d.ts.map +1 -0
  213. package/dist/maestro/core/status.js +369 -0
  214. package/dist/maestro/core/status.js.map +1 -0
  215. package/dist/maestro/core/supervision.d.ts +56 -0
  216. package/dist/maestro/core/supervision.d.ts.map +1 -0
  217. package/dist/maestro/core/supervision.js +249 -0
  218. package/dist/maestro/core/supervision.js.map +1 -0
  219. package/dist/maestro/core/surface-provider.d.ts +200 -0
  220. package/dist/maestro/core/surface-provider.d.ts.map +1 -0
  221. package/dist/maestro/core/surface-provider.js +71 -0
  222. package/dist/maestro/core/surface-provider.js.map +1 -0
  223. package/dist/maestro/core/types.d.ts +388 -0
  224. package/dist/maestro/core/types.d.ts.map +1 -0
  225. package/dist/maestro/core/types.js +2 -0
  226. package/dist/maestro/core/types.js.map +1 -0
  227. package/dist/maestro/core/undelivered-children.d.ts +27 -0
  228. package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
  229. package/dist/maestro/core/undelivered-children.js +31 -0
  230. package/dist/maestro/core/undelivered-children.js.map +1 -0
  231. package/dist/maestro/core/wake.d.ts +32 -0
  232. package/dist/maestro/core/wake.d.ts.map +1 -0
  233. package/dist/maestro/core/wake.js +125 -0
  234. package/dist/maestro/core/wake.js.map +1 -0
  235. package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
  236. package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
  237. package/dist/maestro/core/worktree-cleanup.js +278 -0
  238. package/dist/maestro/core/worktree-cleanup.js.map +1 -0
  239. package/dist/maestro/core/worktree.d.ts +50 -0
  240. package/dist/maestro/core/worktree.d.ts.map +1 -0
  241. package/dist/maestro/core/worktree.js +23 -0
  242. package/dist/maestro/core/worktree.js.map +1 -0
  243. package/dist/maestro/engine.d.ts +5 -0
  244. package/dist/maestro/engine.d.ts.map +1 -0
  245. package/dist/maestro/engine.js +5 -0
  246. package/dist/maestro/engine.js.map +1 -0
  247. package/dist/maestro/pi/child.d.ts +8 -0
  248. package/dist/maestro/pi/child.d.ts.map +1 -0
  249. package/dist/maestro/pi/child.js +8 -0
  250. package/dist/maestro/pi/child.js.map +1 -0
  251. package/dist/maestro/pi/extension.d.ts +10 -0
  252. package/dist/maestro/pi/extension.d.ts.map +1 -0
  253. package/dist/maestro/pi/extension.js +8 -0
  254. package/dist/maestro/pi/extension.js.map +1 -0
  255. package/dist/maestro/pi/subagents-index.d.ts +9 -0
  256. package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
  257. package/dist/maestro/pi/subagents-index.js +9 -0
  258. package/dist/maestro/pi/subagents-index.js.map +1 -0
  259. package/dist/maestro/pi.d.ts +9 -0
  260. package/dist/maestro/pi.d.ts.map +1 -0
  261. package/dist/maestro/pi.js +7 -0
  262. package/dist/maestro/pi.js.map +1 -0
  263. package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
  264. package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
  265. package/dist/maestro/runtime/accept-recheck.js +92 -0
  266. package/dist/maestro/runtime/accept-recheck.js.map +1 -0
  267. package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
  268. package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
  269. package/dist/maestro/runtime/delegated-marker.js +200 -0
  270. package/dist/maestro/runtime/delegated-marker.js.map +1 -0
  271. package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
  272. package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
  273. package/dist/maestro/runtime/host-surface-binding.js +2 -0
  274. package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
  275. package/dist/maestro/runtime/index.d.ts +10 -0
  276. package/dist/maestro/runtime/index.d.ts.map +1 -0
  277. package/dist/maestro/runtime/index.js +6 -0
  278. package/dist/maestro/runtime/index.js.map +1 -0
  279. package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
  280. package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
  281. package/dist/maestro/runtime/pi-persistent-io.js +64 -0
  282. package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
  283. package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
  284. package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
  285. package/dist/maestro/runtime/pi-run-session-types.js +2 -0
  286. package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
  287. package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
  288. package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
  289. package/dist/maestro/runtime/pi-run-session.js +809 -0
  290. package/dist/maestro/runtime/pi-run-session.js.map +1 -0
  291. package/dist/maestro/runtime/run-session.d.ts +129 -0
  292. package/dist/maestro/runtime/run-session.d.ts.map +1 -0
  293. package/dist/maestro/runtime/run-session.js +680 -0
  294. package/dist/maestro/runtime/run-session.js.map +1 -0
  295. package/dist/maestro/runtime/surface-retention.d.ts +3 -0
  296. package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
  297. package/dist/maestro/runtime/surface-retention.js +5 -0
  298. package/dist/maestro/runtime/surface-retention.js.map +1 -0
  299. package/dist/maestro/runtime/task-model-init.d.ts +34 -0
  300. package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
  301. package/dist/maestro/runtime/task-model-init.js +78 -0
  302. package/dist/maestro/runtime/task-model-init.js.map +1 -0
  303. package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
  304. package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
  305. package/dist/maestro/runtime/worktree-operations.js +633 -0
  306. package/dist/maestro/runtime/worktree-operations.js.map +1 -0
  307. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
  308. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
  309. package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
  310. package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
  311. package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
  312. package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
  313. package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
  314. package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
  315. package/dist/maestro/testing/index.d.ts +5 -0
  316. package/dist/maestro/testing/index.d.ts.map +1 -0
  317. package/dist/maestro/testing/index.js +5 -0
  318. package/dist/maestro/testing/index.js.map +1 -0
  319. package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
  320. package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
  321. package/dist/maestro/testing/surface-provider.conformance.js +167 -0
  322. package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
  323. package/dist/pi-extension/subagents/catalog.d.ts +70 -0
  324. package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
  325. package/dist/pi-extension/subagents/catalog.js +231 -0
  326. package/dist/pi-extension/subagents/catalog.js.map +1 -0
  327. package/dist/pi-extension/subagents/config-path.d.ts +6 -0
  328. package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
  329. package/dist/pi-extension/subagents/config-path.js +21 -0
  330. package/dist/pi-extension/subagents/config-path.js.map +1 -0
  331. package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
  332. package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
  333. package/dist/pi-extension/subagents/control-tools.js +150 -0
  334. package/dist/pi-extension/subagents/control-tools.js.map +1 -0
  335. package/dist/pi-extension/subagents/controls.d.ts +52 -0
  336. package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
  337. package/dist/pi-extension/subagents/controls.js +173 -0
  338. package/dist/pi-extension/subagents/controls.js.map +1 -0
  339. package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
  340. package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
  341. package/dist/pi-extension/subagents/deferred-tools.js +67 -0
  342. package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
  343. package/dist/pi-extension/subagents/delivery.d.ts +22 -0
  344. package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
  345. package/dist/pi-extension/subagents/delivery.js +365 -0
  346. package/dist/pi-extension/subagents/delivery.js.map +1 -0
  347. package/dist/pi-extension/subagents/extension.d.ts +100 -0
  348. package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
  349. package/dist/pi-extension/subagents/extension.js +367 -0
  350. package/dist/pi-extension/subagents/extension.js.map +1 -0
  351. package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
  352. package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
  353. package/dist/pi-extension/subagents/launch-tools.js +373 -0
  354. package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
  355. package/dist/pi-extension/subagents/launch.d.ts +86 -0
  356. package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
  357. package/dist/pi-extension/subagents/launch.js +133 -0
  358. package/dist/pi-extension/subagents/launch.js.map +1 -0
  359. package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
  360. package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
  361. package/dist/pi-extension/subagents/model-registry.js +52 -0
  362. package/dist/pi-extension/subagents/model-registry.js.map +1 -0
  363. package/dist/pi-extension/subagents/observation.d.ts +38 -0
  364. package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
  365. package/dist/pi-extension/subagents/observation.js +168 -0
  366. package/dist/pi-extension/subagents/observation.js.map +1 -0
  367. package/dist/pi-extension/subagents/persistent.d.ts +72 -0
  368. package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
  369. package/dist/pi-extension/subagents/persistent.js +322 -0
  370. package/dist/pi-extension/subagents/persistent.js.map +1 -0
  371. package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
  372. package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
  373. package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
  374. package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
  375. package/dist/pi-extension/subagents/presentation.d.ts +149 -0
  376. package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
  377. package/dist/pi-extension/subagents/presentation.js +419 -0
  378. package/dist/pi-extension/subagents/presentation.js.map +1 -0
  379. package/dist/pi-extension/subagents/state.d.ts +183 -0
  380. package/dist/pi-extension/subagents/state.d.ts.map +1 -0
  381. package/dist/pi-extension/subagents/state.js +92 -0
  382. package/dist/pi-extension/subagents/state.js.map +1 -0
  383. package/dist/pi-extension/subagents/task-models.d.ts +9 -0
  384. package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
  385. package/dist/pi-extension/subagents/task-models.js +293 -0
  386. package/dist/pi-extension/subagents/task-models.js.map +1 -0
  387. package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
  388. package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
  389. package/dist/pi-extension/subagents/tool-boundary.js +53 -0
  390. package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
  391. package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
  392. package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
  393. package/dist/pi-extension/subagents/worktree-tools.js +185 -0
  394. package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
  395. package/dist/provenance.json +5 -0
  396. package/package.json +540 -27
  397. package/index.d.ts +0 -1
  398. package/index.js +0 -2
@@ -0,0 +1,322 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { projectLifecycle } from "../../maestro/core/lifecycle.js";
3
+ import { NOTICE_CAP } from "../../maestro/core/specialist-notice.js";
4
+ import {} from "./state.js";
5
+ import { encodeHostValue, HOST_PATH_CHARS, } from "../../maestro/core/host-text.js";
6
+ import { hostLine, hostText, list, sendParentMessage, value, } from "./presentation.js";
7
+ export function asPiRecord(running) {
8
+ // SAFETY: live rows are the adapter's actual records. Legacy presentation
9
+ // fixtures omit script/activity paths, which persistent I/O never consumes.
10
+ return running;
11
+ }
12
+ export function persistentSpecialistState(running) {
13
+ const projection = projectLifecycle(running.lifecycle, Date.now()).kind;
14
+ if (projection === "completed" ||
15
+ projection === "failed" ||
16
+ projection === "finalizing")
17
+ return "stopped";
18
+ if (running.stopState === "failed" || asPiRecord(running).launchFailure)
19
+ return "stalled";
20
+ if (running.stopState)
21
+ return projection === "stalled" ? "stalled" : "working";
22
+ if (running.taskId)
23
+ return projection === "stalled" ? "stalled" : "working";
24
+ // Persistent task completion is authoritative for logical specialist state.
25
+ // Herdr can continue reporting the long-lived Pi pane as working while the
26
+ // process remains open between turns.
27
+ if (running.persistent && running.tasksCompleted != null)
28
+ return "idle";
29
+ if (projection === "stalled")
30
+ return "stalled";
31
+ if (projection === "active" ||
32
+ projection === "blocked" ||
33
+ projection === "starting" ||
34
+ projection === "running")
35
+ return "working";
36
+ return "idle";
37
+ }
38
+ export function persistentSpecialistFacts(running, io, worktree) {
39
+ const facts = {
40
+ logicalId: running.logicalId,
41
+ generationId: running.generationId,
42
+ policyHash: running.policyHash,
43
+ tasks: io.readLedger(asPiRecord(running)).map((entry) => ({
44
+ task: entry.task,
45
+ outcome: entry.outcome,
46
+ })),
47
+ sessionFile: running.sessionFile,
48
+ lastObservedPhase: projectLifecycle(running.lifecycle, Date.now()).kind,
49
+ };
50
+ if (worktree)
51
+ facts.worktree = worktree;
52
+ return facts;
53
+ }
54
+ /**
55
+ * Facts for a crash or stop notice. The ledger is child-writable, so its
56
+ * outcomes are one bounded list of encoded entries with an omitted count;
57
+ * details keep every entry.
58
+ */
59
+ export function persistentFactsFields(facts) {
60
+ const fields = [
61
+ hostLine `Logical ID: ${facts.logicalId}`,
62
+ hostLine `Generation ID: ${facts.generationId}`,
63
+ hostLine `Policy hash: ${facts.policyHash}`,
64
+ {
65
+ ...hostLine `Task outcomes: ${list(facts.tasks.map((task) => `${task.task}=${task.outcome}`), "ledger entries")}`,
66
+ drop: 1,
67
+ },
68
+ hostLine `Session: ${value(facts.sessionFile, HOST_PATH_CHARS)}`,
69
+ hostLine `Last observed phase: ${facts.lastObservedPhase}`,
70
+ ];
71
+ if (facts.worktree)
72
+ fields.push(hostLine `Worktree Git state: ${facts.worktree.gitError ? "unknown" : facts.worktree.conflicted ? "conflicted" : facts.worktree.clean ? "clean" : "dirty"}`);
73
+ return fields;
74
+ }
75
+ function sendPersistentStopFailure(api, facts) {
76
+ sendParentMessage(api, "subagent_stop", {
77
+ head: [
78
+ [
79
+ hostText("Persistent specialist stop failed: process exit was not confirmed. Evidence is retained."),
80
+ ],
81
+ ],
82
+ evidence: [persistentFactsFields(facts)],
83
+ }, { status: "failed", facts });
84
+ }
85
+ /** Persistent specialist controls bound to one extension instance. */
86
+ export function createPersistentControls({ runtime, persistentConfig, resolveInterruptTarget, }) {
87
+ const runningSubagents = runtime.runningSubagents;
88
+ function formatLivePersistentSpecialists() {
89
+ const specialists = Array.from(runningSubagents.values()).filter((running) => running.persistent);
90
+ if (specialists.length === 0)
91
+ return [];
92
+ return [
93
+ "Live persistent specialists:",
94
+ ...specialists.map((running) => {
95
+ const allowlist = running.policyTools?.join(",") ?? "unrestricted";
96
+ const denied = running.policyDeniedTools?.join(",") || "none";
97
+ return `• ${encodeHostValue(running.name)} | ${encodeHostValue(running.logicalId ?? "")} | ${encodeHostValue(running.generationId ?? "")} | ${encodeHostValue(running.agent ?? "bare")} | ${persistentSpecialistState(running)} | ${running.tasksCompleted ?? 0} completed | tools: ${encodeHostValue(allowlist, HOST_PATH_CHARS)}; denied: ${encodeHostValue(denied, HOST_PATH_CHARS)}; persistent: true${running.notify ? `; notices: ${running.noticeBudget?.delivered ?? 0} of ${NOTICE_CAP} delivered` : ""}`;
98
+ }),
99
+ ];
100
+ }
101
+ function resolvePersistentTarget(params) {
102
+ const resolved = resolveInterruptTarget(params);
103
+ if ("error" in resolved)
104
+ return resolved;
105
+ if (!resolved.running.persistent) {
106
+ return {
107
+ error: `Subagent "${encodeHostValue(resolved.running.name)}" is not persistent.`,
108
+ };
109
+ }
110
+ return resolved;
111
+ }
112
+ function persistentCapacityError(config = persistentConfig) {
113
+ const specialists = Array.from(runningSubagents.values()).filter((running) => running.persistent);
114
+ const acquiring = [...(runtime.persistentReservations ?? [])].filter((id) => !runningSubagents.get(id)?.persistent).length;
115
+ if (specialists.length + acquiring < config.maxAgents)
116
+ return undefined;
117
+ return `Persistent specialist cap (${config.maxAgents}) reached. Current specialists: ${specialists.map((running) => `${encodeHostValue(running.name)} (${persistentSpecialistState(running)}, ${running.tasksCompleted ?? 0} completed)`).join(", ")}. Launches acquiring resources: ${acquiring}.`;
118
+ }
119
+ function notifyStopFailure(running, io) {
120
+ let retry;
121
+ let busy = false, cancelled = false;
122
+ const attempt = (running.stopAttempt ??= {});
123
+ attempt.cancelNotice?.();
124
+ const current = () => !cancelled &&
125
+ runningSubagents.get(running.id) === running &&
126
+ running.stopAttempt === attempt &&
127
+ running.stopState === "failed" &&
128
+ running.lifecycle.delivery === "pending" &&
129
+ !["finalizing", "completed", "failed"].includes(running.lifecycle.process.kind);
130
+ const cancel = () => {
131
+ cancelled = true;
132
+ if (retry)
133
+ clearTimeout(retry);
134
+ const queue = runtime.heldDeliveries;
135
+ const at = queue?.indexOf(notice) ?? -1;
136
+ if (at >= 0)
137
+ queue?.splice(at, 1);
138
+ if (attempt.cancelNotice === cancel)
139
+ attempt.cancelNotice = undefined;
140
+ };
141
+ attempt.cancelNotice = cancel;
142
+ const hold = () => {
143
+ if (!current() || (!runtime.liveApi && !runtime.reloadGap))
144
+ return cancel();
145
+ const queue = (runtime.heldDeliveries ??= []);
146
+ if (!queue.includes(notice))
147
+ queue.push(notice);
148
+ if (!runtime.liveApi)
149
+ return;
150
+ retry = setTimeout(() => {
151
+ if (!runtime.liveApi && runtime.reloadGap)
152
+ return;
153
+ const at = queue.indexOf(notice);
154
+ if (at < 0)
155
+ return;
156
+ queue.splice(at, 1);
157
+ notice.release(runtime.liveApi);
158
+ }, 1_000);
159
+ retry.unref();
160
+ };
161
+ const notice = {
162
+ id: running.id,
163
+ release(api) {
164
+ if (retry)
165
+ clearTimeout(retry);
166
+ if (!api || !current())
167
+ return cancel();
168
+ if (busy)
169
+ return;
170
+ busy = true;
171
+ void (async () => {
172
+ try {
173
+ const worktree = await io.inspectWorktree(asPiRecord(running));
174
+ // Evidence collection can cross reload, successful exit, or another stop.
175
+ if (!current())
176
+ return cancel();
177
+ const liveApi = runtime.liveApi;
178
+ if (!liveApi) {
179
+ hold();
180
+ return;
181
+ }
182
+ sendPersistentStopFailure(liveApi, persistentSpecialistFacts(running, io, worktree));
183
+ cancel();
184
+ }
185
+ catch {
186
+ hold();
187
+ }
188
+ finally {
189
+ busy = false;
190
+ }
191
+ })();
192
+ },
193
+ };
194
+ if (runtime.liveApi)
195
+ notice.release(runtime.liveApi);
196
+ else if (runtime.reloadGap)
197
+ (runtime.heldDeliveries ??= []).push(notice);
198
+ }
199
+ function startPersistentStopTimeout(running, _api, stopTimeoutMs = 15_000, io) {
200
+ if (running.stopTimeout ||
201
+ persistentSpecialistState(running) === "stopped" ||
202
+ (running.stopState !== "requested" && running.stopState !== "pending"))
203
+ return;
204
+ running.stopTimeout = setTimeout(() => {
205
+ running.stopTimeout = undefined;
206
+ if (!runningSubagents.has(running.id) ||
207
+ persistentSpecialistState(running) === "stopped")
208
+ return;
209
+ if (running.stopState === "requested" ||
210
+ running.stopState === "pending") {
211
+ running.stopState = "failed";
212
+ running.stopFailure =
213
+ "process exit was not confirmed within the bounded stop wait";
214
+ notifyStopFailure(running, io);
215
+ }
216
+ }, stopTimeoutMs);
217
+ running.stopTimeout.unref();
218
+ }
219
+ function handleSubagentStop(params, api, stopTimeoutMs = 15_000, io) {
220
+ const resolved = resolvePersistentTarget(params);
221
+ if ("error" in resolved) {
222
+ return {
223
+ content: [{ type: "text", text: resolved.error }],
224
+ details: { error: resolved.error },
225
+ };
226
+ }
227
+ const running = resolved.running;
228
+ const shownName = encodeHostValue(running.name);
229
+ if (persistentSpecialistState(running) === "stopped") {
230
+ const error = `Persistent specialist "${shownName}" is already stopped.`;
231
+ return {
232
+ content: [{ type: "text", text: error }],
233
+ details: { error, id: running.id, name: running.name },
234
+ };
235
+ }
236
+ if (running.stopState === "requested" || running.stopState === "pending") {
237
+ const error = `Stop is already requested for persistent specialist "${shownName}".`;
238
+ return {
239
+ content: [{ type: "text", text: error }],
240
+ details: { error, id: running.id, name: running.name },
241
+ };
242
+ }
243
+ const pending = running.taskId != null && !asPiRecord(running).launchFailure;
244
+ running.stopAttempt?.cancelNotice?.();
245
+ running.stopAttempt = {};
246
+ running.stopState = pending ? "pending" : "requested";
247
+ running.stopTimeoutMs = stopTimeoutMs;
248
+ running.stopFailure = undefined;
249
+ try {
250
+ io.requestStop(asPiRecord(running));
251
+ }
252
+ catch (error) {
253
+ running.stopState = "failed";
254
+ running.stopFailure = `stop publication failed: ${String(error)}`;
255
+ throw new Error(`${running.stopFailure}. Evidence is retained and follow-up work is blocked; request subagent_stop again to retry.`, { cause: error });
256
+ }
257
+ if (!pending)
258
+ startPersistentStopTimeout(running, api, stopTimeoutMs, io);
259
+ return {
260
+ content: [
261
+ {
262
+ type: "text",
263
+ text: pending
264
+ ? `Stop pending for persistent specialist "${shownName}"; its active task will settle first.`
265
+ : `Stop requested for persistent specialist "${shownName}".`,
266
+ },
267
+ ],
268
+ details: {
269
+ id: running.id,
270
+ name: running.name,
271
+ status: pending ? "stop_pending" : "stop_requested",
272
+ },
273
+ };
274
+ }
275
+ function handleSubagentSend(params, io) {
276
+ const resolved = resolvePersistentTarget(params);
277
+ if ("error" in resolved)
278
+ return {
279
+ content: [{ type: "text", text: resolved.error }],
280
+ details: { error: resolved.error },
281
+ };
282
+ const running = resolved.running;
283
+ const shownName = encodeHostValue(running.name);
284
+ const task = randomUUID();
285
+ const state = persistentSpecialistState(running);
286
+ if (running.stopState === "failed" && state !== "stopped") {
287
+ io.rejectBusy(asPiRecord(running), task);
288
+ const error = `Persistent specialist "${shownName}" is in an unconfirmed-stop state; task ${task} was rejected-busy. Process exit is unconfirmed and evidence is retained at session ${encodeHostValue(running.sessionFile, HOST_PATH_CHARS)}. Request subagent_stop again or spawn a new specialist.`;
289
+ return {
290
+ content: [{ type: "text", text: error }],
291
+ details: { error, task, outcome: "rejected-busy" },
292
+ };
293
+ }
294
+ if (state !== "idle") {
295
+ io.rejectBusy(asPiRecord(running), task);
296
+ const error = `Persistent specialist "${shownName}" is ${state}; task ${task} was rejected-busy. Resend after the pending result.`;
297
+ return {
298
+ content: [{ type: "text", text: error }],
299
+ details: { error, task, outcome: "rejected-busy" },
300
+ };
301
+ }
302
+ const inbox = io.dispatch(asPiRecord(running), task, params.message);
303
+ return {
304
+ content: [
305
+ {
306
+ type: "text",
307
+ text: `Task ${task} dispatched to persistent specialist "${shownName}".`,
308
+ },
309
+ ],
310
+ details: { id: running.id, task, inbox, outcome: "dispatched" },
311
+ };
312
+ }
313
+ return {
314
+ formatLivePersistentSpecialists,
315
+ resolvePersistentTarget,
316
+ persistentCapacityError,
317
+ startPersistentStopTimeout,
318
+ handleSubagentStop,
319
+ handleSubagentSend,
320
+ };
321
+ }
322
+ //# sourceMappingURL=persistent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistent.js","sourceRoot":"","sources":["../../../pi-extension/subagents/persistent.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tAgentToolResult,\n\tExtensionAPI,\n} from \"@earendil-works/pi-coding-agent\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n\tPiRunRecord,\n\tPiPersistentIO,\n} from \"../../maestro/runtime/index.ts\";\nimport type { PersistentConfig } from \"../../maestro/core/config/persistent-config.ts\";\nimport { projectLifecycle } from \"../../maestro/core/lifecycle.ts\";\nimport { NOTICE_CAP } from \"../../maestro/core/specialist-notice.ts\";\nimport type { WorktreeHandoff } from \"../../maestro/core/worktree.ts\";\nimport {\n\ttype RunningSubagent,\n\ttype SubagentRuntime,\n\ttype HeldDelivery,\n} from \"./state.ts\";\nimport type { Controls } from \"./controls.ts\";\nimport {\n\tencodeHostValue,\n\tHOST_PATH_CHARS,\n} from \"../../maestro/core/host-text.ts\";\nimport {\n\ttype HostField,\n\thostLine,\n\thostText,\n\tlist,\n\tsendParentMessage,\n\tvalue,\n} from \"./presentation.ts\";\n\nexport function asPiRecord(running: RunningSubagent): PiRunRecord {\n\t// SAFETY: live rows are the adapter's actual records. Legacy presentation\n\t// fixtures omit script/activity paths, which persistent I/O never consumes.\n\treturn running as PiRunRecord;\n}\n\nexport function persistentSpecialistState(\n\trunning: RunningSubagent,\n): \"idle\" | \"working\" | \"stalled\" | \"stopped\" {\n\tconst projection = projectLifecycle(running.lifecycle, Date.now()).kind;\n\tif (\n\t\tprojection === \"completed\" ||\n\t\tprojection === \"failed\" ||\n\t\tprojection === \"finalizing\"\n\t)\n\t\treturn \"stopped\";\n\tif (running.stopState === \"failed\" || asPiRecord(running).launchFailure)\n\t\treturn \"stalled\";\n\tif (running.stopState)\n\t\treturn projection === \"stalled\" ? \"stalled\" : \"working\";\n\tif (running.taskId) return projection === \"stalled\" ? \"stalled\" : \"working\";\n\t// Persistent task completion is authoritative for logical specialist state.\n\t// Herdr can continue reporting the long-lived Pi pane as working while the\n\t// process remains open between turns.\n\tif (running.persistent && running.tasksCompleted != null) return \"idle\";\n\tif (projection === \"stalled\") return \"stalled\";\n\tif (\n\t\tprojection === \"active\" ||\n\t\tprojection === \"blocked\" ||\n\t\tprojection === \"starting\" ||\n\t\tprojection === \"running\"\n\t)\n\t\treturn \"working\";\n\treturn \"idle\";\n}\n\nexport interface SubagentSendDetails {\n\terror?: string;\n\tid?: string;\n\ttask?: string;\n\tinbox?: string;\n\toutcome?: \"dispatched\" | \"rejected-busy\";\n}\n\ninterface PersistentSpecialistFacts {\n\tlogicalId: string;\n\tgenerationId: string;\n\tpolicyHash: string;\n\ttasks: Array<{ task: string; outcome: string }>;\n\tsessionFile: string;\n\tworktree?: WorktreeHandoff;\n\tlastObservedPhase: string;\n}\n\nexport function persistentSpecialistFacts(\n\trunning: RunningSubagent,\n\tio: PiPersistentIO,\n\tworktree?: WorktreeHandoff,\n): PersistentSpecialistFacts {\n\tconst facts: PersistentSpecialistFacts = {\n\t\tlogicalId: running.logicalId!,\n\t\tgenerationId: running.generationId!,\n\t\tpolicyHash: running.policyHash!,\n\t\ttasks: io.readLedger(asPiRecord(running)).map((entry) => ({\n\t\t\ttask: entry.task,\n\t\t\toutcome: entry.outcome,\n\t\t})),\n\t\tsessionFile: running.sessionFile,\n\t\tlastObservedPhase: projectLifecycle(running.lifecycle, Date.now()).kind,\n\t};\n\tif (worktree) facts.worktree = worktree;\n\treturn facts;\n}\n\n/**\n * Facts for a crash or stop notice. The ledger is child-writable, so its\n * outcomes are one bounded list of encoded entries with an omitted count;\n * details keep every entry.\n */\nexport function persistentFactsFields(\n\tfacts: PersistentSpecialistFacts,\n): HostField[] {\n\tconst fields = [\n\t\thostLine`Logical ID: ${facts.logicalId}`,\n\t\thostLine`Generation ID: ${facts.generationId}`,\n\t\thostLine`Policy hash: ${facts.policyHash}`,\n\t\t{\n\t\t\t...hostLine`Task outcomes: ${list(\n\t\t\t\tfacts.tasks.map((task) => `${task.task}=${task.outcome}`),\n\t\t\t\t\"ledger entries\",\n\t\t\t)}`,\n\t\t\tdrop: 1,\n\t\t},\n\t\thostLine`Session: ${value(facts.sessionFile, HOST_PATH_CHARS)}`,\n\t\thostLine`Last observed phase: ${facts.lastObservedPhase}`,\n\t];\n\tif (facts.worktree)\n\t\tfields.push(\n\t\t\thostLine`Worktree Git state: ${facts.worktree.gitError ? \"unknown\" : facts.worktree.conflicted ? \"conflicted\" : facts.worktree.clean ? \"clean\" : \"dirty\"}`,\n\t\t);\n\treturn fields;\n}\n\nfunction sendPersistentStopFailure(\n\tapi: Pick<ExtensionAPI, \"sendMessage\">,\n\tfacts: PersistentSpecialistFacts,\n): void {\n\tsendParentMessage(\n\t\tapi,\n\t\t\"subagent_stop\",\n\t\t{\n\t\t\thead: [\n\t\t\t\t[\n\t\t\t\t\thostText(\n\t\t\t\t\t\t\"Persistent specialist stop failed: process exit was not confirmed. Evidence is retained.\",\n\t\t\t\t\t),\n\t\t\t\t],\n\t\t\t],\n\t\t\tevidence: [persistentFactsFields(facts)],\n\t\t},\n\t\t{ status: \"failed\", facts },\n\t);\n}\n\nexport interface SubagentStopDetails {\n\terror?: string;\n\tid?: string;\n\tname?: string;\n\tstatus?: \"stop_requested\" | \"stop_pending\";\n}\n\ninterface PersistentControlDeps {\n\truntime: SubagentRuntime;\n\tpersistentConfig: PersistentConfig;\n\tresolveInterruptTarget: Controls[\"resolveInterruptTarget\"];\n}\n\nexport type PersistentControls = ReturnType<typeof createPersistentControls>;\n\n/** Persistent specialist controls bound to one extension instance. */\nexport function createPersistentControls({\n\truntime,\n\tpersistentConfig,\n\tresolveInterruptTarget,\n}: PersistentControlDeps) {\n\tconst runningSubagents = runtime.runningSubagents;\n\n\tfunction formatLivePersistentSpecialists(): string[] {\n\t\tconst specialists = Array.from(runningSubagents.values()).filter(\n\t\t\t(running) => running.persistent,\n\t\t);\n\t\tif (specialists.length === 0) return [];\n\t\treturn [\n\t\t\t\"Live persistent specialists:\",\n\t\t\t...specialists.map((running) => {\n\t\t\t\tconst allowlist = running.policyTools?.join(\",\") ?? \"unrestricted\";\n\t\t\t\tconst denied = running.policyDeniedTools?.join(\",\") || \"none\";\n\t\t\t\treturn `• ${encodeHostValue(running.name)} | ${encodeHostValue(running.logicalId ?? \"\")} | ${encodeHostValue(running.generationId ?? \"\")} | ${encodeHostValue(running.agent ?? \"bare\")} | ${persistentSpecialistState(running)} | ${running.tasksCompleted ?? 0} completed | tools: ${encodeHostValue(allowlist, HOST_PATH_CHARS)}; denied: ${encodeHostValue(denied, HOST_PATH_CHARS)}; persistent: true${running.notify ? `; notices: ${running.noticeBudget?.delivered ?? 0} of ${NOTICE_CAP} delivered` : \"\"}`;\n\t\t\t}),\n\t\t];\n\t}\n\n\tfunction resolvePersistentTarget(params: { id?: string; name?: string }) {\n\t\tconst resolved = resolveInterruptTarget(params);\n\t\tif (\"error\" in resolved) return resolved;\n\t\tif (!resolved.running.persistent) {\n\t\t\treturn {\n\t\t\t\terror: `Subagent \"${encodeHostValue(resolved.running.name)}\" is not persistent.`,\n\t\t\t};\n\t\t}\n\t\treturn resolved;\n\t}\n\n\tfunction persistentCapacityError(\n\t\tconfig: PersistentConfig = persistentConfig,\n\t): string | undefined {\n\t\tconst specialists = Array.from(runningSubagents.values()).filter(\n\t\t\t(running) => running.persistent,\n\t\t);\n\t\tconst acquiring = [...(runtime.persistentReservations ?? [])].filter(\n\t\t\t(id) => !runningSubagents.get(id)?.persistent,\n\t\t).length;\n\t\tif (specialists.length + acquiring < config.maxAgents) return undefined;\n\t\treturn `Persistent specialist cap (${config.maxAgents}) reached. Current specialists: ${specialists.map((running) => `${encodeHostValue(running.name)} (${persistentSpecialistState(running)}, ${running.tasksCompleted ?? 0} completed)`).join(\", \")}. Launches acquiring resources: ${acquiring}.`;\n\t}\n\n\tfunction notifyStopFailure(\n\t\trunning: RunningSubagent,\n\t\tio: PiPersistentIO,\n\t): void {\n\t\tlet retry: ReturnType<typeof setTimeout> | undefined;\n\t\tlet busy = false,\n\t\t\tcancelled = false;\n\t\tconst attempt = (running.stopAttempt ??= {});\n\t\tattempt.cancelNotice?.();\n\t\tconst current = () =>\n\t\t\t!cancelled &&\n\t\t\trunningSubagents.get(running.id) === running &&\n\t\t\trunning.stopAttempt === attempt &&\n\t\t\trunning.stopState === \"failed\" &&\n\t\t\trunning.lifecycle.delivery === \"pending\" &&\n\t\t\t![\"finalizing\", \"completed\", \"failed\"].includes(\n\t\t\t\trunning.lifecycle.process.kind,\n\t\t\t);\n\t\tconst cancel = () => {\n\t\t\tcancelled = true;\n\t\t\tif (retry) clearTimeout(retry);\n\t\t\tconst queue = runtime.heldDeliveries;\n\t\t\tconst at = queue?.indexOf(notice) ?? -1;\n\t\t\tif (at >= 0) queue?.splice(at, 1);\n\t\t\tif (attempt.cancelNotice === cancel) attempt.cancelNotice = undefined;\n\t\t};\n\t\tattempt.cancelNotice = cancel;\n\t\tconst hold = () => {\n\t\t\tif (!current() || (!runtime.liveApi && !runtime.reloadGap))\n\t\t\t\treturn cancel();\n\t\t\tconst queue = (runtime.heldDeliveries ??= []);\n\t\t\tif (!queue.includes(notice)) queue.push(notice);\n\t\t\tif (!runtime.liveApi) return;\n\t\t\tretry = setTimeout(() => {\n\t\t\t\tif (!runtime.liveApi && runtime.reloadGap) return;\n\t\t\t\tconst at = queue.indexOf(notice);\n\t\t\t\tif (at < 0) return;\n\t\t\t\tqueue.splice(at, 1);\n\t\t\t\tnotice.release(runtime.liveApi);\n\t\t\t}, 1_000);\n\t\t\tretry.unref();\n\t\t};\n\t\tconst notice: HeldDelivery = {\n\t\t\tid: running.id,\n\t\t\trelease(api) {\n\t\t\t\tif (retry) clearTimeout(retry);\n\t\t\t\tif (!api || !current()) return cancel();\n\t\t\t\tif (busy) return;\n\t\t\t\tbusy = true;\n\t\t\t\tvoid (async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst worktree = await io.inspectWorktree(asPiRecord(running));\n\t\t\t\t\t\t// Evidence collection can cross reload, successful exit, or another stop.\n\t\t\t\t\t\tif (!current()) return cancel();\n\t\t\t\t\t\tconst liveApi = runtime.liveApi;\n\t\t\t\t\t\tif (!liveApi) {\n\t\t\t\t\t\t\thold();\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tsendPersistentStopFailure(\n\t\t\t\t\t\t\tliveApi,\n\t\t\t\t\t\t\tpersistentSpecialistFacts(running, io, worktree),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tcancel();\n\t\t\t\t\t} catch {\n\t\t\t\t\t\thold();\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tbusy = false;\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t},\n\t\t};\n\t\tif (runtime.liveApi) notice.release(runtime.liveApi);\n\t\telse if (runtime.reloadGap) (runtime.heldDeliveries ??= []).push(notice);\n\t}\n\n\tfunction startPersistentStopTimeout(\n\t\trunning: RunningSubagent,\n\t\t_api: Pick<ExtensionAPI, \"sendMessage\">,\n\t\tstopTimeoutMs = 15_000,\n\t\tio: PiPersistentIO,\n\t): void {\n\t\tif (\n\t\t\trunning.stopTimeout ||\n\t\t\tpersistentSpecialistState(running) === \"stopped\" ||\n\t\t\t(running.stopState !== \"requested\" && running.stopState !== \"pending\")\n\t\t)\n\t\t\treturn;\n\t\trunning.stopTimeout = setTimeout(() => {\n\t\t\trunning.stopTimeout = undefined;\n\t\t\tif (\n\t\t\t\t!runningSubagents.has(running.id) ||\n\t\t\t\tpersistentSpecialistState(running) === \"stopped\"\n\t\t\t)\n\t\t\t\treturn;\n\t\t\tif (\n\t\t\t\trunning.stopState === \"requested\" ||\n\t\t\t\trunning.stopState === \"pending\"\n\t\t\t) {\n\t\t\t\trunning.stopState = \"failed\";\n\t\t\t\trunning.stopFailure =\n\t\t\t\t\t\"process exit was not confirmed within the bounded stop wait\";\n\t\t\t\tnotifyStopFailure(running, io);\n\t\t\t}\n\t\t}, stopTimeoutMs);\n\t\trunning.stopTimeout.unref();\n\t}\n\n\tfunction handleSubagentStop(\n\t\tparams: { id?: string; name?: string },\n\t\tapi: Pick<ExtensionAPI, \"sendMessage\">,\n\t\tstopTimeoutMs = 15_000,\n\t\tio: PiPersistentIO,\n\t): AgentToolResult<SubagentStopDetails> {\n\t\tconst resolved = resolvePersistentTarget(params);\n\t\tif (\"error\" in resolved) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: resolved.error }],\n\t\t\t\tdetails: { error: resolved.error },\n\t\t\t};\n\t\t}\n\t\tconst running = resolved.running;\n\t\tconst shownName = encodeHostValue(running.name);\n\t\tif (persistentSpecialistState(running) === \"stopped\") {\n\t\t\tconst error = `Persistent specialist \"${shownName}\" is already stopped.`;\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: error }],\n\t\t\t\tdetails: { error, id: running.id, name: running.name },\n\t\t\t};\n\t\t}\n\t\tif (running.stopState === \"requested\" || running.stopState === \"pending\") {\n\t\t\tconst error = `Stop is already requested for persistent specialist \"${shownName}\".`;\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: error }],\n\t\t\t\tdetails: { error, id: running.id, name: running.name },\n\t\t\t};\n\t\t}\n\t\tconst pending =\n\t\t\trunning.taskId != null && !asPiRecord(running).launchFailure;\n\t\trunning.stopAttempt?.cancelNotice?.();\n\t\trunning.stopAttempt = {};\n\t\trunning.stopState = pending ? \"pending\" : \"requested\";\n\t\trunning.stopTimeoutMs = stopTimeoutMs;\n\t\trunning.stopFailure = undefined;\n\t\ttry {\n\t\t\tio.requestStop(asPiRecord(running));\n\t\t} catch (error) {\n\t\t\trunning.stopState = \"failed\";\n\t\t\trunning.stopFailure = `stop publication failed: ${String(error)}`;\n\t\t\tthrow new Error(\n\t\t\t\t`${running.stopFailure}. Evidence is retained and follow-up work is blocked; request subagent_stop again to retry.`,\n\t\t\t\t{ cause: error },\n\t\t\t);\n\t\t}\n\t\tif (!pending) startPersistentStopTimeout(running, api, stopTimeoutMs, io);\n\t\treturn {\n\t\t\tcontent: [\n\t\t\t\t{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: pending\n\t\t\t\t\t\t? `Stop pending for persistent specialist \"${shownName}\"; its active task will settle first.`\n\t\t\t\t\t\t: `Stop requested for persistent specialist \"${shownName}\".`,\n\t\t\t\t},\n\t\t\t],\n\t\t\tdetails: {\n\t\t\t\tid: running.id,\n\t\t\t\tname: running.name,\n\t\t\t\tstatus: pending ? \"stop_pending\" : \"stop_requested\",\n\t\t\t},\n\t\t};\n\t}\n\n\tfunction handleSubagentSend(\n\t\tparams: {\n\t\t\tid?: string;\n\t\t\tname?: string;\n\t\t\tmessage: string;\n\t\t},\n\t\tio: PiPersistentIO,\n\t): AgentToolResult<SubagentSendDetails> {\n\t\tconst resolved = resolvePersistentTarget(params);\n\t\tif (\"error\" in resolved)\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: resolved.error }],\n\t\t\t\tdetails: { error: resolved.error },\n\t\t\t};\n\t\tconst running = resolved.running;\n\t\tconst shownName = encodeHostValue(running.name);\n\t\tconst task = randomUUID();\n\t\tconst state = persistentSpecialistState(running);\n\t\tif (running.stopState === \"failed\" && state !== \"stopped\") {\n\t\t\tio.rejectBusy(asPiRecord(running), task);\n\t\t\tconst error = `Persistent specialist \"${shownName}\" is in an unconfirmed-stop state; task ${task} was rejected-busy. Process exit is unconfirmed and evidence is retained at session ${encodeHostValue(running.sessionFile, HOST_PATH_CHARS)}. Request subagent_stop again or spawn a new specialist.`;\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: error }],\n\t\t\t\tdetails: { error, task, outcome: \"rejected-busy\" },\n\t\t\t};\n\t\t}\n\t\tif (state !== \"idle\") {\n\t\t\tio.rejectBusy(asPiRecord(running), task);\n\t\t\tconst error = `Persistent specialist \"${shownName}\" is ${state}; task ${task} was rejected-busy. Resend after the pending result.`;\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: error }],\n\t\t\t\tdetails: { error, task, outcome: \"rejected-busy\" },\n\t\t\t};\n\t\t}\n\t\tconst inbox = io.dispatch(asPiRecord(running), task, params.message);\n\t\treturn {\n\t\t\tcontent: [\n\t\t\t\t{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: `Task ${task} dispatched to persistent specialist \"${shownName}\".`,\n\t\t\t\t},\n\t\t\t],\n\t\t\tdetails: { id: running.id, task, inbox, outcome: \"dispatched\" },\n\t\t};\n\t}\n\n\treturn {\n\t\tformatLivePersistentSpecialists,\n\t\tresolvePersistentTarget,\n\t\tpersistentCapacityError,\n\t\tstartPersistentStopTimeout,\n\t\thandleSubagentStop,\n\t\thandleSubagentSend,\n\t};\n}\n"]}
@@ -0,0 +1,25 @@
1
+ import type { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
2
+ import type { SupervisionConfig } from "../../maestro/core/config/supervision-config.ts";
3
+ import type { StatusConfig } from "../../maestro/core/status.ts";
4
+ import type { RunningSubagent, SubagentRuntime } from "./state.ts";
5
+ import type { Observation } from "./observation.ts";
6
+ export type PiToolRenderers = Partial<Record<"subagent" | "subagent_resume" | "subagent_interrupt" | "subagent_cancel" | "subagents_list", Pick<ToolDefinition<any, any>, "renderCall" | "renderResult">>>;
7
+ export interface PiPresentationHooks {
8
+ createWidgets(deps: {
9
+ runtime: SubagentRuntime;
10
+ statusConfig: StatusConfig;
11
+ supervisionConfig: SupervisionConfig;
12
+ observeRunningSubagent: Observation["observeRunningSubagent"];
13
+ evaluateNoProgressAdvisory: Observation["evaluateNoProgressAdvisory"];
14
+ }): {
15
+ renderSubagentWidgetLines(agents: RunningSubagent[], width: number): string[];
16
+ updateWidget(): void;
17
+ startStatusRefresh(pi: ExtensionAPI): void;
18
+ startWidgetRefresh(): void;
19
+ stopRefresh(): void;
20
+ };
21
+ borderLine(left: string, right: string, width: number, accent?: string): string;
22
+ registerMessageRenderers(pi: ExtensionAPI): void;
23
+ toolRenderers?: PiToolRenderers;
24
+ }
25
+ //# sourceMappingURL=presentation-hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presentation-hooks.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/presentation-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,cAAc,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,OAAO,CACpC,MAAM,CACH,UAAU,GACV,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,EAClB,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,CAC7D,CACD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IACnC,aAAa,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,eAAe,CAAC;QACzB,YAAY,EAAE,YAAY,CAAC;QAC3B,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,sBAAsB,EAAE,WAAW,CAAC,wBAAwB,CAAC,CAAC;QAC9D,0BAA0B,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;KACtE,GAAG;QACH,yBAAyB,CACxB,MAAM,EAAE,eAAe,EAAE,EACzB,KAAK,EAAE,MAAM,GACX,MAAM,EAAE,CAAC;QACZ,YAAY,IAAI,IAAI,CAAC;QACrB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;QAC3C,kBAAkB,IAAI,IAAI,CAAC;QAC3B,WAAW,IAAI,IAAI,CAAC;KACpB,CAAC;IACF,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACb,MAAM,CAAC;IACV,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;IACjD,aAAa,CAAC,EAAE,eAAe,CAAC;CAChC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=presentation-hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presentation-hooks.js","sourceRoot":"","sources":["../../../pi-extension/subagents/presentation-hooks.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tExtensionAPI,\n\tToolDefinition,\n} from \"@earendil-works/pi-coding-agent\";\nimport type { SupervisionConfig } from \"../../maestro/core/config/supervision-config.ts\";\nimport type { StatusConfig } from \"../../maestro/core/status.ts\";\nimport type { RunningSubagent, SubagentRuntime } from \"./state.ts\";\nimport type { Observation } from \"./observation.ts\";\n\nexport type PiToolRenderers = Partial<\n\tRecord<\n\t\t| \"subagent\"\n\t\t| \"subagent_resume\"\n\t\t| \"subagent_interrupt\"\n\t\t| \"subagent_cancel\"\n\t\t| \"subagents_list\",\n\t\tPick<ToolDefinition<any, any>, \"renderCall\" | \"renderResult\">\n\t>\n>;\n\nexport interface PiPresentationHooks {\n\tcreateWidgets(deps: {\n\t\truntime: SubagentRuntime;\n\t\tstatusConfig: StatusConfig;\n\t\tsupervisionConfig: SupervisionConfig;\n\t\tobserveRunningSubagent: Observation[\"observeRunningSubagent\"];\n\t\tevaluateNoProgressAdvisory: Observation[\"evaluateNoProgressAdvisory\"];\n\t}): {\n\t\trenderSubagentWidgetLines(\n\t\t\tagents: RunningSubagent[],\n\t\t\twidth: number,\n\t\t): string[];\n\t\tupdateWidget(): void;\n\t\tstartStatusRefresh(pi: ExtensionAPI): void;\n\t\tstartWidgetRefresh(): void;\n\t\tstopRefresh(): void;\n\t};\n\tborderLine(\n\t\tleft: string,\n\t\tright: string,\n\t\twidth: number,\n\t\taccent?: string,\n\t): string;\n\tregisterMessageRenderers(pi: ExtensionAPI): void;\n\ttoolRenderers?: PiToolRenderers;\n}\n"]}
@@ -0,0 +1,149 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import type { RunCancellation } from "../../maestro/core/types.ts";
3
+ import type { ResolvedRuntimePlan } from "../../maestro/core/routing.ts";
4
+ import type { WorktreeHandoff } from "../../maestro/core/worktree.ts";
5
+ import { type AcceptOutcome } from "../../maestro/core/accept.ts";
6
+ import type { ModelFailure, SubagentResult } from "./state.ts";
7
+ export declare function getFirstText(content: readonly {
8
+ type: string;
9
+ text?: string;
10
+ }[]): string;
11
+ export declare function formatElapsed(seconds: number): string;
12
+ /** Host-authored label text: a template's static part. */
13
+ export interface HostText {
14
+ kind: "text";
15
+ text: string;
16
+ }
17
+ /** A child-, transcript- or environment-influenced value in a host line. */
18
+ export interface HostValue {
19
+ kind: "value";
20
+ value: string;
21
+ maxChars: number;
22
+ }
23
+ /** Values shown as whole encoded items within `maxChars`, then a count. */
24
+ export interface HostList {
25
+ kind: "list";
26
+ values: readonly string[];
27
+ noun: string;
28
+ maxChars: number;
29
+ }
30
+ /** An argument its builder serialized losslessly; never encoded or cut. */
31
+ export interface HostCommand {
32
+ kind: "command";
33
+ text: string;
34
+ }
35
+ export type HostPart = HostText | HostValue | HostList | HostCommand;
36
+ /**
37
+ * One host line: host-authored label text (the template's static parts) and
38
+ * the values between them. `drop` ranks a field for the whole-message budget:
39
+ * higher ranks go first; a field without a rank is kept.
40
+ */
41
+ export interface HostField {
42
+ parts: readonly HostPart[];
43
+ drop?: number;
44
+ }
45
+ export type ChildReportKind = "result" | "failure" | "help-request" | "task-result";
46
+ export interface ParentMessage {
47
+ /** Host paragraphs before the report; never dropped. */
48
+ head: HostField[][];
49
+ /** The child's own output, delivered only inside the envelope. */
50
+ report?: {
51
+ name: string;
52
+ kind: ChildReportKind;
53
+ body: string;
54
+ };
55
+ /** Host evidence paragraphs after the report. */
56
+ evidence?: HostField[][];
57
+ /** End with the parent-action continuation prompt. */
58
+ continuation?: boolean;
59
+ }
60
+ /** A display value with an explicit bound. */
61
+ export declare function value(text: string, maxChars?: number): HostValue;
62
+ export declare function list(values: readonly string[], noun: string, maxChars?: number): HostList;
63
+ /**
64
+ * A host line from a template. Static text is host-authored by construction;
65
+ * every interpolated string is a value the serializer encodes and bounds.
66
+ */
67
+ export declare function hostLine(strings: TemplateStringsArray, ...values: Array<string | HostValue | HostList | HostCommand>): HostField;
68
+ /** A host line of constant host prose. */
69
+ export declare function hostText(text: string): HostField;
70
+ /** The one serializer for parent delivery messages. */
71
+ export declare function renderParentMessage(message: ParentMessage): string;
72
+ export interface ChildReportParts {
73
+ /** Host text before the framing sentence. */
74
+ before: string;
75
+ report?: {
76
+ from: string;
77
+ kind: string;
78
+ body: string;
79
+ };
80
+ /** Host evidence after the closing tag. */
81
+ after: string;
82
+ }
83
+ /**
84
+ * Split a delivered message into its host text and its one child report. Host
85
+ * values are encoded and child bodies neutralized, so the first framing
86
+ * sentence and the first closing tag after it are the host's own.
87
+ */
88
+ export declare function splitChildReport(text: string): ChildReportParts;
89
+ /**
90
+ * The serialized Resume line exactly as the model-facing message carries it.
91
+ * Renderers show this line; they never rebuild a command from display text.
92
+ */
93
+ export declare function resumeCommandLine(sessionFile: string): string;
94
+ /** Session lines; the resume command appears only in an exact one-line form. */
95
+ export declare function sessionFields(sessionFile: string | undefined): HostField[];
96
+ export declare function worktreeHandoffFields(worktree: WorktreeHandoff): HostField[];
97
+ /**
98
+ * The verdict line, directly under the status line in the head. Unchecked
99
+ * runs read `Check: none`. Changed check files are child-controlled names.
100
+ */
101
+ export declare function checkField(accept: AcceptOutcome | undefined): HostField;
102
+ export interface SubagentResultDetails {
103
+ name: string;
104
+ task?: string;
105
+ agent?: string;
106
+ exitCode?: number;
107
+ elapsed?: number;
108
+ sessionFile?: string;
109
+ logicalId?: string;
110
+ generationId?: string;
111
+ policyHash?: string;
112
+ error?: string;
113
+ errorMessage?: string;
114
+ fallbackAttempts?: string[];
115
+ fallbackFailures?: ModelFailure[];
116
+ worktree?: WorktreeHandoff;
117
+ runtimePlan?: ResolvedRuntimePlan;
118
+ cancellation?: RunCancellation;
119
+ /** The verdict and its evidence; absent means no check (`none`). */
120
+ accept?: AcceptOutcome;
121
+ }
122
+ export interface SubagentPingDetails {
123
+ name: string;
124
+ /** The name the child wrote in its sidecar, when it differs from `name`. */
125
+ reportedName?: string;
126
+ message: string;
127
+ agent?: string;
128
+ sessionFile: string;
129
+ worktree?: WorktreeHandoff;
130
+ accept?: AcceptOutcome;
131
+ }
132
+ /** Send one delivery message; its content always comes from the serializer. */
133
+ export declare function sendParentMessage<TDetails extends object>(api: Pick<ExtensionAPI, "sendMessage">, customType: string, message: ParentMessage, details: TDetails, options?: {
134
+ triggerTurn: boolean;
135
+ deliverAs?: "steer";
136
+ }): void;
137
+ /** A result: the model sees the continuation; the human view does not. */
138
+ export declare function sendSubagentResult(api: Pick<ExtensionAPI, "sendMessage">, message: ParentMessage, details: SubagentResultDetails): void;
139
+ export declare function launchDiagnosticsText(diagnostics: readonly string[] | undefined, prefix: string, suffix: string): string;
140
+ /**
141
+ * A summary body: the child's own text is the enveloped report; a host
142
+ * fallback or a relayed error is one encoded host line.
143
+ */
144
+ export declare function summaryMessage(result: Pick<SubagentResult, "summary" | "summarySource">, name: string, kind: ChildReportKind): Pick<ParentMessage, "report"> & {
145
+ head: HostField[][];
146
+ };
147
+ export declare function resolveResultPresentation(result: Pick<SubagentResult, "exitCode" | "elapsed" | "summary" | "summarySource" | "sessionFile" | "errorMessage" | "fallbackAttempts" | "fallbackFailures" | "runtimePlan" | "worktree" | "accept">, name: string, runtimeMismatch?: string): ParentMessage;
148
+ export declare function resolveCancelledPresentation(result: Pick<SubagentResult, "elapsed" | "sessionFile" | "fallbackAttempts" | "worktree" | "accept">, name: string, cancellation: RunCancellation): ParentMessage;
149
+ //# sourceMappingURL=presentation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/presentation.ts"],"names":[],"mappings":"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"}