@nubl/maestro 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/README.md +56 -3
  2. package/dist/config.json.example +30 -0
  3. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
  4. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
  5. package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
  6. package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
  7. package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
  8. package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
  9. package/dist/maestro/adapters/pi/accept-groups.js +70 -0
  10. package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
  11. package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
  12. package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
  13. package/dist/maestro/adapters/pi/accept-runner.js +161 -0
  14. package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
  15. package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
  16. package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
  17. package/dist/maestro/adapters/pi/activity-file.js +454 -0
  18. package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
  19. package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
  20. package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
  21. package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
  22. package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
  23. package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
  24. package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
  25. package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
  26. package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
  27. package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
  28. package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
  29. package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
  30. package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
  31. package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
  32. package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
  33. package/dist/maestro/adapters/pi/child/entry.js +3 -0
  34. package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
  35. package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
  36. package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
  37. package/dist/maestro/adapters/pi/child/protocol.js +510 -0
  38. package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
  39. package/dist/maestro/adapters/pi/completion.d.ts +45 -0
  40. package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
  41. package/dist/maestro/adapters/pi/completion.js +295 -0
  42. package/dist/maestro/adapters/pi/completion.js.map +1 -0
  43. package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
  44. package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
  45. package/dist/maestro/adapters/pi/launch-command.js +75 -0
  46. package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
  47. package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
  48. package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
  49. package/dist/maestro/adapters/pi/launch-operations.js +270 -0
  50. package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
  51. package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
  52. package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
  53. package/dist/maestro/adapters/pi/launch-resume.js +183 -0
  54. package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
  55. package/dist/maestro/adapters/pi/launch.d.ts +148 -0
  56. package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
  57. package/dist/maestro/adapters/pi/launch.js +655 -0
  58. package/dist/maestro/adapters/pi/launch.js.map +1 -0
  59. package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
  60. package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
  61. package/dist/maestro/adapters/pi/model-registry.js +29 -0
  62. package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
  63. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
  64. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
  65. package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
  66. package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
  67. package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
  68. package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
  69. package/dist/maestro/adapters/pi/process-identity.js +248 -0
  70. package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
  71. package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
  72. package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
  73. package/dist/maestro/adapters/pi/process-tree.js +69 -0
  74. package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
  75. package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
  76. package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
  77. package/dist/maestro/adapters/pi/script-shell.js +43 -0
  78. package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
  79. package/dist/maestro/adapters/pi/session.d.ts +207 -0
  80. package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
  81. package/dist/maestro/adapters/pi/session.js +714 -0
  82. package/dist/maestro/adapters/pi/session.js.map +1 -0
  83. package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
  84. package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
  85. package/dist/maestro/adapters/pi/task-model-init.js +47 -0
  86. package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
  87. package/dist/maestro/core/accept.d.ts +150 -0
  88. package/dist/maestro/core/accept.d.ts.map +1 -0
  89. package/dist/maestro/core/accept.js +243 -0
  90. package/dist/maestro/core/accept.js.map +1 -0
  91. package/dist/maestro/core/activity.d.ts +4 -0
  92. package/dist/maestro/core/activity.d.ts.map +1 -0
  93. package/dist/maestro/core/activity.js +18 -0
  94. package/dist/maestro/core/activity.js.map +1 -0
  95. package/dist/maestro/core/child-busy.d.ts +14 -0
  96. package/dist/maestro/core/child-busy.d.ts.map +1 -0
  97. package/dist/maestro/core/child-busy.js +14 -0
  98. package/dist/maestro/core/child-busy.js.map +1 -0
  99. package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
  100. package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
  101. package/dist/maestro/core/config/guidelines-config.js +60 -0
  102. package/dist/maestro/core/config/guidelines-config.js.map +1 -0
  103. package/dist/maestro/core/config/herdr-config.d.ts +13 -0
  104. package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
  105. package/dist/maestro/core/config/herdr-config.js +65 -0
  106. package/dist/maestro/core/config/herdr-config.js.map +1 -0
  107. package/dist/maestro/core/config/model-config.d.ts +92 -0
  108. package/dist/maestro/core/config/model-config.d.ts.map +1 -0
  109. package/dist/maestro/core/config/model-config.js +522 -0
  110. package/dist/maestro/core/config/model-config.js.map +1 -0
  111. package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
  112. package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
  113. package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
  114. package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
  115. package/dist/maestro/core/config/pane-config.d.ts +15 -0
  116. package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
  117. package/dist/maestro/core/config/pane-config.js +101 -0
  118. package/dist/maestro/core/config/pane-config.js.map +1 -0
  119. package/dist/maestro/core/config/persistent-config.d.ts +7 -0
  120. package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
  121. package/dist/maestro/core/config/persistent-config.js +72 -0
  122. package/dist/maestro/core/config/persistent-config.js.map +1 -0
  123. package/dist/maestro/core/config/role-config.d.ts +7 -0
  124. package/dist/maestro/core/config/role-config.d.ts.map +1 -0
  125. package/dist/maestro/core/config/role-config.js +74 -0
  126. package/dist/maestro/core/config/role-config.js.map +1 -0
  127. package/dist/maestro/core/config/spawning-config.d.ts +7 -0
  128. package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
  129. package/dist/maestro/core/config/spawning-config.js +65 -0
  130. package/dist/maestro/core/config/spawning-config.js.map +1 -0
  131. package/dist/maestro/core/config/supervision-config.d.ts +7 -0
  132. package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
  133. package/dist/maestro/core/config/supervision-config.js +69 -0
  134. package/dist/maestro/core/config/supervision-config.js.map +1 -0
  135. package/dist/maestro/core/config/task-model-init.d.ts +118 -0
  136. package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
  137. package/dist/maestro/core/config/task-model-init.js +168 -0
  138. package/dist/maestro/core/config/task-model-init.js.map +1 -0
  139. package/dist/maestro/core/config/task-model-types.d.ts +36 -0
  140. package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
  141. package/dist/maestro/core/config/task-model-types.js +17 -0
  142. package/dist/maestro/core/config/task-model-types.js.map +1 -0
  143. package/dist/maestro/core/config/type-guards.d.ts +22 -0
  144. package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
  145. package/dist/maestro/core/config/type-guards.js +31 -0
  146. package/dist/maestro/core/config/type-guards.js.map +1 -0
  147. package/dist/maestro/core/deadline.d.ts +11 -0
  148. package/dist/maestro/core/deadline.d.ts.map +1 -0
  149. package/dist/maestro/core/deadline.js +30 -0
  150. package/dist/maestro/core/deadline.js.map +1 -0
  151. package/dist/maestro/core/declared-skills.d.ts +16 -0
  152. package/dist/maestro/core/declared-skills.d.ts.map +1 -0
  153. package/dist/maestro/core/declared-skills.js +52 -0
  154. package/dist/maestro/core/declared-skills.js.map +1 -0
  155. package/dist/maestro/core/delegation-depth.d.ts +38 -0
  156. package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
  157. package/dist/maestro/core/delegation-depth.js +59 -0
  158. package/dist/maestro/core/delegation-depth.js.map +1 -0
  159. package/dist/maestro/core/git-environment.d.ts +3 -0
  160. package/dist/maestro/core/git-environment.d.ts.map +1 -0
  161. package/dist/maestro/core/git-environment.js +29 -0
  162. package/dist/maestro/core/git-environment.js.map +1 -0
  163. package/dist/maestro/core/harness-adapter.d.ts +89 -0
  164. package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
  165. package/dist/maestro/core/harness-adapter.js +2 -0
  166. package/dist/maestro/core/harness-adapter.js.map +1 -0
  167. package/dist/maestro/core/host-text.d.ts +49 -0
  168. package/dist/maestro/core/host-text.d.ts.map +1 -0
  169. package/dist/maestro/core/host-text.js +106 -0
  170. package/dist/maestro/core/host-text.js.map +1 -0
  171. package/dist/maestro/core/index.d.ts +4 -0
  172. package/dist/maestro/core/index.d.ts.map +1 -0
  173. package/dist/maestro/core/index.js +2 -0
  174. package/dist/maestro/core/index.js.map +1 -0
  175. package/dist/maestro/core/lifecycle.d.ts +16 -0
  176. package/dist/maestro/core/lifecycle.d.ts.map +1 -0
  177. package/dist/maestro/core/lifecycle.js +429 -0
  178. package/dist/maestro/core/lifecycle.js.map +1 -0
  179. package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
  180. package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
  181. package/dist/maestro/core/opened-primary-workspace.js +49 -0
  182. package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
  183. package/dist/maestro/core/platform-support.d.ts +15 -0
  184. package/dist/maestro/core/platform-support.d.ts.map +1 -0
  185. package/dist/maestro/core/platform-support.js +23 -0
  186. package/dist/maestro/core/platform-support.js.map +1 -0
  187. package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
  188. package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
  189. package/dist/maestro/core/realpath-without-opening.js +45 -0
  190. package/dist/maestro/core/realpath-without-opening.js.map +1 -0
  191. package/dist/maestro/core/roles/discovery.d.ts +64 -0
  192. package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
  193. package/dist/maestro/core/roles/discovery.js +422 -0
  194. package/dist/maestro/core/roles/discovery.js.map +1 -0
  195. package/dist/maestro/core/routing.d.ts +115 -0
  196. package/dist/maestro/core/routing.d.ts.map +1 -0
  197. package/dist/maestro/core/routing.js +449 -0
  198. package/dist/maestro/core/routing.js.map +1 -0
  199. package/dist/maestro/core/script-launch.d.ts +47 -0
  200. package/dist/maestro/core/script-launch.d.ts.map +1 -0
  201. package/dist/maestro/core/script-launch.js +102 -0
  202. package/dist/maestro/core/script-launch.js.map +1 -0
  203. package/dist/maestro/core/shell.d.ts +2 -0
  204. package/dist/maestro/core/shell.d.ts.map +1 -0
  205. package/dist/maestro/core/shell.js +4 -0
  206. package/dist/maestro/core/shell.js.map +1 -0
  207. package/dist/maestro/core/specialist-notice.d.ts +36 -0
  208. package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
  209. package/dist/maestro/core/specialist-notice.js +41 -0
  210. package/dist/maestro/core/specialist-notice.js.map +1 -0
  211. package/dist/maestro/core/status.d.ts +87 -0
  212. package/dist/maestro/core/status.d.ts.map +1 -0
  213. package/dist/maestro/core/status.js +369 -0
  214. package/dist/maestro/core/status.js.map +1 -0
  215. package/dist/maestro/core/supervision.d.ts +56 -0
  216. package/dist/maestro/core/supervision.d.ts.map +1 -0
  217. package/dist/maestro/core/supervision.js +249 -0
  218. package/dist/maestro/core/supervision.js.map +1 -0
  219. package/dist/maestro/core/surface-provider.d.ts +200 -0
  220. package/dist/maestro/core/surface-provider.d.ts.map +1 -0
  221. package/dist/maestro/core/surface-provider.js +71 -0
  222. package/dist/maestro/core/surface-provider.js.map +1 -0
  223. package/dist/maestro/core/types.d.ts +388 -0
  224. package/dist/maestro/core/types.d.ts.map +1 -0
  225. package/dist/maestro/core/types.js +2 -0
  226. package/dist/maestro/core/types.js.map +1 -0
  227. package/dist/maestro/core/undelivered-children.d.ts +27 -0
  228. package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
  229. package/dist/maestro/core/undelivered-children.js +31 -0
  230. package/dist/maestro/core/undelivered-children.js.map +1 -0
  231. package/dist/maestro/core/wake.d.ts +32 -0
  232. package/dist/maestro/core/wake.d.ts.map +1 -0
  233. package/dist/maestro/core/wake.js +125 -0
  234. package/dist/maestro/core/wake.js.map +1 -0
  235. package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
  236. package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
  237. package/dist/maestro/core/worktree-cleanup.js +278 -0
  238. package/dist/maestro/core/worktree-cleanup.js.map +1 -0
  239. package/dist/maestro/core/worktree.d.ts +50 -0
  240. package/dist/maestro/core/worktree.d.ts.map +1 -0
  241. package/dist/maestro/core/worktree.js +23 -0
  242. package/dist/maestro/core/worktree.js.map +1 -0
  243. package/dist/maestro/engine.d.ts +5 -0
  244. package/dist/maestro/engine.d.ts.map +1 -0
  245. package/dist/maestro/engine.js +5 -0
  246. package/dist/maestro/engine.js.map +1 -0
  247. package/dist/maestro/pi/child.d.ts +8 -0
  248. package/dist/maestro/pi/child.d.ts.map +1 -0
  249. package/dist/maestro/pi/child.js +8 -0
  250. package/dist/maestro/pi/child.js.map +1 -0
  251. package/dist/maestro/pi/extension.d.ts +10 -0
  252. package/dist/maestro/pi/extension.d.ts.map +1 -0
  253. package/dist/maestro/pi/extension.js +8 -0
  254. package/dist/maestro/pi/extension.js.map +1 -0
  255. package/dist/maestro/pi/subagents-index.d.ts +9 -0
  256. package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
  257. package/dist/maestro/pi/subagents-index.js +9 -0
  258. package/dist/maestro/pi/subagents-index.js.map +1 -0
  259. package/dist/maestro/pi.d.ts +9 -0
  260. package/dist/maestro/pi.d.ts.map +1 -0
  261. package/dist/maestro/pi.js +7 -0
  262. package/dist/maestro/pi.js.map +1 -0
  263. package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
  264. package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
  265. package/dist/maestro/runtime/accept-recheck.js +92 -0
  266. package/dist/maestro/runtime/accept-recheck.js.map +1 -0
  267. package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
  268. package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
  269. package/dist/maestro/runtime/delegated-marker.js +200 -0
  270. package/dist/maestro/runtime/delegated-marker.js.map +1 -0
  271. package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
  272. package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
  273. package/dist/maestro/runtime/host-surface-binding.js +2 -0
  274. package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
  275. package/dist/maestro/runtime/index.d.ts +10 -0
  276. package/dist/maestro/runtime/index.d.ts.map +1 -0
  277. package/dist/maestro/runtime/index.js +6 -0
  278. package/dist/maestro/runtime/index.js.map +1 -0
  279. package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
  280. package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
  281. package/dist/maestro/runtime/pi-persistent-io.js +64 -0
  282. package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
  283. package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
  284. package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
  285. package/dist/maestro/runtime/pi-run-session-types.js +2 -0
  286. package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
  287. package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
  288. package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
  289. package/dist/maestro/runtime/pi-run-session.js +809 -0
  290. package/dist/maestro/runtime/pi-run-session.js.map +1 -0
  291. package/dist/maestro/runtime/run-session.d.ts +129 -0
  292. package/dist/maestro/runtime/run-session.d.ts.map +1 -0
  293. package/dist/maestro/runtime/run-session.js +680 -0
  294. package/dist/maestro/runtime/run-session.js.map +1 -0
  295. package/dist/maestro/runtime/surface-retention.d.ts +3 -0
  296. package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
  297. package/dist/maestro/runtime/surface-retention.js +5 -0
  298. package/dist/maestro/runtime/surface-retention.js.map +1 -0
  299. package/dist/maestro/runtime/task-model-init.d.ts +34 -0
  300. package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
  301. package/dist/maestro/runtime/task-model-init.js +78 -0
  302. package/dist/maestro/runtime/task-model-init.js.map +1 -0
  303. package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
  304. package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
  305. package/dist/maestro/runtime/worktree-operations.js +633 -0
  306. package/dist/maestro/runtime/worktree-operations.js.map +1 -0
  307. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
  308. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
  309. package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
  310. package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
  311. package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
  312. package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
  313. package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
  314. package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
  315. package/dist/maestro/testing/index.d.ts +5 -0
  316. package/dist/maestro/testing/index.d.ts.map +1 -0
  317. package/dist/maestro/testing/index.js +5 -0
  318. package/dist/maestro/testing/index.js.map +1 -0
  319. package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
  320. package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
  321. package/dist/maestro/testing/surface-provider.conformance.js +167 -0
  322. package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
  323. package/dist/pi-extension/subagents/catalog.d.ts +70 -0
  324. package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
  325. package/dist/pi-extension/subagents/catalog.js +231 -0
  326. package/dist/pi-extension/subagents/catalog.js.map +1 -0
  327. package/dist/pi-extension/subagents/config-path.d.ts +6 -0
  328. package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
  329. package/dist/pi-extension/subagents/config-path.js +21 -0
  330. package/dist/pi-extension/subagents/config-path.js.map +1 -0
  331. package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
  332. package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
  333. package/dist/pi-extension/subagents/control-tools.js +150 -0
  334. package/dist/pi-extension/subagents/control-tools.js.map +1 -0
  335. package/dist/pi-extension/subagents/controls.d.ts +52 -0
  336. package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
  337. package/dist/pi-extension/subagents/controls.js +173 -0
  338. package/dist/pi-extension/subagents/controls.js.map +1 -0
  339. package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
  340. package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
  341. package/dist/pi-extension/subagents/deferred-tools.js +67 -0
  342. package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
  343. package/dist/pi-extension/subagents/delivery.d.ts +22 -0
  344. package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
  345. package/dist/pi-extension/subagents/delivery.js +365 -0
  346. package/dist/pi-extension/subagents/delivery.js.map +1 -0
  347. package/dist/pi-extension/subagents/extension.d.ts +100 -0
  348. package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
  349. package/dist/pi-extension/subagents/extension.js +367 -0
  350. package/dist/pi-extension/subagents/extension.js.map +1 -0
  351. package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
  352. package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
  353. package/dist/pi-extension/subagents/launch-tools.js +373 -0
  354. package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
  355. package/dist/pi-extension/subagents/launch.d.ts +86 -0
  356. package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
  357. package/dist/pi-extension/subagents/launch.js +133 -0
  358. package/dist/pi-extension/subagents/launch.js.map +1 -0
  359. package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
  360. package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
  361. package/dist/pi-extension/subagents/model-registry.js +52 -0
  362. package/dist/pi-extension/subagents/model-registry.js.map +1 -0
  363. package/dist/pi-extension/subagents/observation.d.ts +38 -0
  364. package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
  365. package/dist/pi-extension/subagents/observation.js +168 -0
  366. package/dist/pi-extension/subagents/observation.js.map +1 -0
  367. package/dist/pi-extension/subagents/persistent.d.ts +72 -0
  368. package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
  369. package/dist/pi-extension/subagents/persistent.js +322 -0
  370. package/dist/pi-extension/subagents/persistent.js.map +1 -0
  371. package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
  372. package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
  373. package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
  374. package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
  375. package/dist/pi-extension/subagents/presentation.d.ts +149 -0
  376. package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
  377. package/dist/pi-extension/subagents/presentation.js +419 -0
  378. package/dist/pi-extension/subagents/presentation.js.map +1 -0
  379. package/dist/pi-extension/subagents/state.d.ts +183 -0
  380. package/dist/pi-extension/subagents/state.d.ts.map +1 -0
  381. package/dist/pi-extension/subagents/state.js +92 -0
  382. package/dist/pi-extension/subagents/state.js.map +1 -0
  383. package/dist/pi-extension/subagents/task-models.d.ts +9 -0
  384. package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
  385. package/dist/pi-extension/subagents/task-models.js +293 -0
  386. package/dist/pi-extension/subagents/task-models.js.map +1 -0
  387. package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
  388. package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
  389. package/dist/pi-extension/subagents/tool-boundary.js +53 -0
  390. package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
  391. package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
  392. package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
  393. package/dist/pi-extension/subagents/worktree-tools.js +185 -0
  394. package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
  395. package/dist/provenance.json +5 -0
  396. package/package.json +540 -27
  397. package/index.d.ts +0 -1
  398. package/index.js +0 -2
@@ -0,0 +1,133 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { resolveProjectTrusted, } from "../../maestro/runtime/index.js";
3
+ import { resolveRuntimePlans, } from "../../maestro/core/routing.js";
4
+ import { sessionModelRegistry } from "./model-registry.js";
5
+ import { resolveModelDefault, } from "../../maestro/core/config/model-config.js";
6
+ import { getAgentConfigDir } from "./config-path.js";
7
+ import { normalizeAcceptSpec } from "../../maestro/core/accept.js";
8
+ import { SubagentParams, resolveDenyTools, discoverAgentCatalog, missingRoleMessage, resolveEffectiveSessionMode, resolveEffectivePersistent, resolveEffectiveAutoExit, resolveEffectiveInteractive, loadAgentDefaults, } from "./catalog.js";
9
+ /** Launch snapshots and runtime plans bound to one extension instance. */
10
+ export function createLaunchPlanner({ runtime, modelConfig, paneConfig, }) {
11
+ function normalizePiAttempt(params, ctx, parentThinking, options) {
12
+ const agentDefs = params.agent
13
+ ? loadAgentDefaults(params.agent, runtime.pi)
14
+ : null;
15
+ if (params.agent && !agentDefs) {
16
+ const diagnostic = discoverAgentCatalog(runtime.pi).diagnostics.find((candidate) => candidate.agentName === params.agent);
17
+ // Raw here: the public tool boundary and the delivery serializer encode.
18
+ throw new Error(diagnostic ? diagnostic.message : missingRoleMessage(params.agent));
19
+ }
20
+ if (!ctx.model)
21
+ throw new Error("Subagent launch requires a resolved parent model");
22
+ const effectiveTools = params.tools ?? agentDefs?.tools;
23
+ const effectiveSkills = params.skills ?? agentDefs?.skills;
24
+ const persistent = resolveEffectivePersistent(params, agentDefs);
25
+ const effectiveAutoExit = resolveEffectiveAutoExit(params, agentDefs);
26
+ const effectiveInteractive = resolveEffectiveInteractive(params, agentDefs);
27
+ const logicalId = options.id;
28
+ const generationId = randomUUID();
29
+ const taskId = randomUUID();
30
+ const parentSessionFile = ctx.sessionManager.getSessionFile();
31
+ if (!parentSessionFile)
32
+ throw new Error("No session file");
33
+ const snapshot = launchSnapshot(ctx, parentThinking);
34
+ return {
35
+ snapshot: {
36
+ ...snapshot,
37
+ parent: { ...snapshot.parent, ...options.origin },
38
+ },
39
+ task: {
40
+ id: options.controlTaskId,
41
+ name: params.name,
42
+ prompt: params.task,
43
+ role: params.agent ?? "",
44
+ cwd: options.origin.cwd,
45
+ worktree: params.worktree ?? undefined,
46
+ accept: params.accept ? normalizeAcceptSpec(params.accept) : undefined,
47
+ requestedModel: params.model,
48
+ session: { mode: resolveEffectiveSessionMode(params, agentDefs) },
49
+ behavior: {
50
+ skills: effectiveSkills
51
+ ?.split(",")
52
+ .map((s) => s.trim())
53
+ .filter(Boolean),
54
+ denyTools: [...resolveDenyTools(agentDefs)],
55
+ autoExit: effectiveAutoExit,
56
+ interactive: effectiveInteractive,
57
+ persistent,
58
+ notify: params.notify === true,
59
+ systemPromptMode: agentDefs?.systemPromptMode,
60
+ },
61
+ systemPrompt: params.agent ? undefined : params.systemPrompt,
62
+ },
63
+ role: agentDefs
64
+ ? {
65
+ ...agentDefs.role,
66
+ systemPrompt: agentDefs.body ?? params.systemPrompt ?? "",
67
+ }
68
+ : {
69
+ name: "",
70
+ version: "1",
71
+ description: "Pi host-resolved role",
72
+ systemPrompt: params.systemPrompt ?? "",
73
+ allowedTools: [],
74
+ },
75
+ resolved: {
76
+ agent: params.agent,
77
+ cwd: params.cwd,
78
+ roleCwd: agentDefs?.cwd,
79
+ tools: effectiveTools,
80
+ },
81
+ identity: { id: logicalId, logicalId, generationId, taskId },
82
+ };
83
+ }
84
+ function resolveSubagentRuntimePlans(params, ctx, parentThinking) {
85
+ const agentDefs = params.agent
86
+ ? loadAgentDefaults(params.agent, runtime.pi)
87
+ : null;
88
+ if (params.agent && !agentDefs) {
89
+ const diagnostic = discoverAgentCatalog(runtime.pi).diagnostics.find((candidate) => candidate.agentName === params.agent);
90
+ // Raw here: the public tool boundary and the delivery serializer encode.
91
+ throw new Error(diagnostic ? diagnostic.message : missingRoleMessage(params.agent));
92
+ }
93
+ if (!ctx.model)
94
+ throw new Error("Subagent launch requires a resolved parent model");
95
+ const plans = resolveRuntimePlans({ model: params.model, thinking: params.thinking }, {
96
+ model: resolveModelDefault(params.agent, agentDefs?.model, modelConfig),
97
+ thinking: agentDefs?.thinking,
98
+ }, {
99
+ provider: ctx.model.provider,
100
+ modelId: ctx.model.id,
101
+ thinking: parentThinking,
102
+ }, sessionModelRegistry(ctx), modelConfig.tasks, !!params.worktree, modelConfig.tasksThinking);
103
+ if (params.worktree && plans.length > 1) {
104
+ throw new Error("Model fallbacks are not supported for worktree subagents.");
105
+ }
106
+ return plans;
107
+ }
108
+ function launchSnapshot(ctx, thinking) {
109
+ return {
110
+ parent: {
111
+ cwd: ctx.cwd,
112
+ invocationCwd: process.cwd(),
113
+ sessionFile: ctx.sessionManager.getSessionFile() ?? "",
114
+ sessionId: ctx.sessionManager.getSessionId(),
115
+ sessionDir: ctx.sessionManager.getSessionDir(),
116
+ agentDir: getAgentConfigDir(),
117
+ },
118
+ parentRuntime: ctx.model && thinking
119
+ ? { provider: ctx.model.provider, modelId: ctx.model.id, thinking }
120
+ : undefined,
121
+ modelRegistry: sessionModelRegistry(ctx),
122
+ paneConfig,
123
+ // Pi 0.79.0 gates project settings but cannot report the decision, so
124
+ // an unreported decision is untrusted wherever Pi has the gate.
125
+ scriptShell: {
126
+ cwd: ctx.cwd,
127
+ projectTrusted: resolveProjectTrusted(ctx.isProjectTrusted?.()),
128
+ },
129
+ };
130
+ }
131
+ return { normalizePiAttempt, resolveSubagentRuntimePlans, launchSnapshot };
132
+ }
133
+ //# sourceMappingURL=launch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../pi-extension/subagents/launch.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport {\n\tresolveProjectTrusted,\n\ttype PiLaunchSnapshot,\n\ttype PiAttemptSnapshot,\n} from \"../../maestro/runtime/index.ts\";\nimport {\n\tresolveRuntimePlans,\n\ttype ResolvedRuntimePlan,\n\ttype ThinkingLevel,\n} from \"../../maestro/core/routing.ts\";\nimport { sessionModelRegistry } from \"./model-registry.ts\";\nimport {\n\tresolveModelDefault,\n\ttype ModelConfig,\n} from \"../../maestro/core/config/model-config.ts\";\nimport { getAgentConfigDir } from \"./config-path.ts\";\nimport { normalizeAcceptSpec } from \"../../maestro/core/accept.ts\";\nimport type { PaneConfig } from \"../../maestro/core/config/pane-config.ts\";\nimport type { SubagentRuntime } from \"./state.ts\";\nimport {\n\tSubagentParams,\n\tresolveDenyTools,\n\tdiscoverAgentCatalog,\n\tmissingRoleMessage,\n\tresolveEffectiveSessionMode,\n\tresolveEffectivePersistent,\n\tresolveEffectiveAutoExit,\n\tresolveEffectiveInteractive,\n\tloadAgentDefaults,\n} from \"./catalog.ts\";\n\ninterface LaunchPlannerDeps {\n\truntime: SubagentRuntime;\n\tmodelConfig: ModelConfig;\n\tpaneConfig: PaneConfig;\n}\n\nexport type LaunchPlanner = ReturnType<typeof createLaunchPlanner>;\n\n/** Launch snapshots and runtime plans bound to one extension instance. */\nexport function createLaunchPlanner({\n\truntime,\n\tmodelConfig,\n\tpaneConfig,\n}: LaunchPlannerDeps) {\n\tfunction normalizePiAttempt(\n\t\tparams: typeof SubagentParams.static,\n\t\tctx: {\n\t\t\tsessionManager: {\n\t\t\t\tgetSessionFile(): string | null | undefined;\n\t\t\t\tgetSessionId(): string;\n\t\t\t\tgetSessionDir(): string;\n\t\t\t};\n\t\t\tcwd: string;\n\t\t\tisProjectTrusted?: () => boolean;\n\t\t\tmodel?: { provider: string; id: string };\n\t\t\tmodelRegistry: {\n\t\t\t\tfind(provider: string, modelId: string): any;\n\t\t\t\tgetAvailable?: () => any[];\n\t\t\t\tgetAll?: () => any[];\n\t\t\t\thasConfiguredAuth?: (model: any) => boolean;\n\t\t\t};\n\t\t},\n\t\tparentThinking: ThinkingLevel,\n\t\toptions: {\n\t\t\tid: string;\n\t\t\tcontrolTaskId: string;\n\t\t\torigin: Pick<PiLaunchSnapshot[\"parent\"], \"cwd\" | \"invocationCwd\">;\n\t\t},\n\t): PiAttemptSnapshot {\n\t\tconst agentDefs = params.agent\n\t\t\t? loadAgentDefaults(params.agent, runtime.pi)\n\t\t\t: null;\n\t\tif (params.agent && !agentDefs) {\n\t\t\tconst diagnostic = discoverAgentCatalog(runtime.pi).diagnostics.find(\n\t\t\t\t(candidate) => candidate.agentName === params.agent,\n\t\t\t);\n\t\t\t// Raw here: the public tool boundary and the delivery serializer encode.\n\t\t\tthrow new Error(\n\t\t\t\tdiagnostic ? diagnostic.message : missingRoleMessage(params.agent),\n\t\t\t);\n\t\t}\n\t\tif (!ctx.model)\n\t\t\tthrow new Error(\"Subagent launch requires a resolved parent model\");\n\n\t\tconst effectiveTools = params.tools ?? agentDefs?.tools;\n\t\tconst effectiveSkills = params.skills ?? agentDefs?.skills;\n\t\tconst persistent = resolveEffectivePersistent(params, agentDefs);\n\t\tconst effectiveAutoExit = resolveEffectiveAutoExit(params, agentDefs);\n\t\tconst effectiveInteractive = resolveEffectiveInteractive(params, agentDefs);\n\t\tconst logicalId = options.id;\n\t\tconst generationId = randomUUID();\n\t\tconst taskId = randomUUID();\n\t\tconst parentSessionFile = ctx.sessionManager.getSessionFile();\n\t\tif (!parentSessionFile) throw new Error(\"No session file\");\n\t\tconst snapshot = launchSnapshot(ctx, parentThinking);\n\n\t\treturn {\n\t\t\tsnapshot: {\n\t\t\t\t...snapshot,\n\t\t\t\tparent: { ...snapshot.parent, ...options.origin },\n\t\t\t},\n\t\t\ttask: {\n\t\t\t\tid: options.controlTaskId,\n\t\t\t\tname: params.name,\n\t\t\t\tprompt: params.task,\n\t\t\t\trole: params.agent ?? \"\",\n\t\t\t\tcwd: options.origin.cwd,\n\t\t\t\tworktree: params.worktree ?? undefined,\n\t\t\t\taccept: params.accept ? normalizeAcceptSpec(params.accept) : undefined,\n\t\t\t\trequestedModel: params.model,\n\t\t\t\tsession: { mode: resolveEffectiveSessionMode(params, agentDefs) },\n\t\t\t\tbehavior: {\n\t\t\t\t\tskills: effectiveSkills\n\t\t\t\t\t\t?.split(\",\")\n\t\t\t\t\t\t.map((s) => s.trim())\n\t\t\t\t\t\t.filter(Boolean),\n\t\t\t\t\tdenyTools: [...resolveDenyTools(agentDefs)],\n\t\t\t\t\tautoExit: effectiveAutoExit,\n\t\t\t\t\tinteractive: effectiveInteractive,\n\t\t\t\t\tpersistent,\n\t\t\t\t\tnotify: params.notify === true,\n\t\t\t\t\tsystemPromptMode: agentDefs?.systemPromptMode,\n\t\t\t\t},\n\t\t\t\tsystemPrompt: params.agent ? undefined : params.systemPrompt,\n\t\t\t},\n\t\t\trole: agentDefs\n\t\t\t\t? {\n\t\t\t\t\t\t...agentDefs.role,\n\t\t\t\t\t\tsystemPrompt: agentDefs.body ?? params.systemPrompt ?? \"\",\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\tname: \"\",\n\t\t\t\t\t\tversion: \"1\",\n\t\t\t\t\t\tdescription: \"Pi host-resolved role\",\n\t\t\t\t\t\tsystemPrompt: params.systemPrompt ?? \"\",\n\t\t\t\t\t\tallowedTools: [],\n\t\t\t\t\t},\n\t\t\tresolved: {\n\t\t\t\tagent: params.agent,\n\t\t\t\tcwd: params.cwd,\n\t\t\t\troleCwd: agentDefs?.cwd,\n\t\t\t\ttools: effectiveTools,\n\t\t\t},\n\t\t\tidentity: { id: logicalId, logicalId, generationId, taskId },\n\t\t};\n\t}\n\n\tfunction resolveSubagentRuntimePlans(\n\t\tparams: typeof SubagentParams.static,\n\t\tctx: Parameters<typeof normalizePiAttempt>[1],\n\t\tparentThinking: ThinkingLevel,\n\t): ResolvedRuntimePlan[] {\n\t\tconst agentDefs = params.agent\n\t\t\t? loadAgentDefaults(params.agent, runtime.pi)\n\t\t\t: null;\n\t\tif (params.agent && !agentDefs) {\n\t\t\tconst diagnostic = discoverAgentCatalog(runtime.pi).diagnostics.find(\n\t\t\t\t(candidate) => candidate.agentName === params.agent,\n\t\t\t);\n\t\t\t// Raw here: the public tool boundary and the delivery serializer encode.\n\t\t\tthrow new Error(\n\t\t\t\tdiagnostic ? diagnostic.message : missingRoleMessage(params.agent),\n\t\t\t);\n\t\t}\n\t\tif (!ctx.model)\n\t\t\tthrow new Error(\"Subagent launch requires a resolved parent model\");\n\t\tconst plans = resolveRuntimePlans(\n\t\t\t{ model: params.model, thinking: params.thinking },\n\t\t\t{\n\t\t\t\tmodel: resolveModelDefault(params.agent, agentDefs?.model, modelConfig),\n\t\t\t\tthinking: agentDefs?.thinking,\n\t\t\t},\n\t\t\t{\n\t\t\t\tprovider: ctx.model.provider,\n\t\t\t\tmodelId: ctx.model.id,\n\t\t\t\tthinking: parentThinking,\n\t\t\t},\n\t\t\tsessionModelRegistry(ctx),\n\t\t\tmodelConfig.tasks,\n\t\t\t!!params.worktree,\n\t\t\tmodelConfig.tasksThinking,\n\t\t);\n\t\tif (params.worktree && plans.length > 1) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Model fallbacks are not supported for worktree subagents.\",\n\t\t\t);\n\t\t}\n\t\treturn plans;\n\t}\n\n\tfunction launchSnapshot(\n\t\tctx: Parameters<typeof normalizePiAttempt>[1],\n\t\tthinking?: ThinkingLevel,\n\t): PiLaunchSnapshot {\n\t\treturn {\n\t\t\tparent: {\n\t\t\t\tcwd: ctx.cwd,\n\t\t\t\tinvocationCwd: process.cwd(),\n\t\t\t\tsessionFile: ctx.sessionManager.getSessionFile() ?? \"\",\n\t\t\t\tsessionId: ctx.sessionManager.getSessionId(),\n\t\t\t\tsessionDir: ctx.sessionManager.getSessionDir(),\n\t\t\t\tagentDir: getAgentConfigDir(),\n\t\t\t},\n\t\t\tparentRuntime:\n\t\t\t\tctx.model && thinking\n\t\t\t\t\t? { provider: ctx.model.provider, modelId: ctx.model.id, thinking }\n\t\t\t\t\t: undefined,\n\t\t\tmodelRegistry: sessionModelRegistry(ctx),\n\t\t\tpaneConfig,\n\t\t\t// Pi 0.79.0 gates project settings but cannot report the decision, so\n\t\t\t// an unreported decision is untrusted wherever Pi has the gate.\n\t\t\tscriptShell: {\n\t\t\t\tcwd: ctx.cwd,\n\t\t\t\tprojectTrusted: resolveProjectTrusted(ctx.isProjectTrusted?.()),\n\t\t\t},\n\t\t};\n\t}\n\n\treturn { normalizePiAttempt, resolveSubagentRuntimePlans, launchSnapshot };\n}\n"]}
@@ -0,0 +1,13 @@
1
+ import { type ModelRegistryAdapter, type RoutingModel, type RoutingRegistrySource } from "../../maestro/core/routing.ts";
2
+ export declare function wrapPiModelRegistry(registry: RoutingRegistrySource): ModelRegistryAdapter;
3
+ interface SessionModelContext {
4
+ modelRegistry: RoutingRegistrySource;
5
+ scopedModels?: readonly {
6
+ model: RoutingModel;
7
+ }[];
8
+ }
9
+ export declare function sessionModelRegistry(ctx: SessionModelContext, env?: NodeJS.ProcessEnv): ModelRegistryAdapter;
10
+ /** The models a scoped session's catalog lists, or undefined when unscoped. */
11
+ export declare function sessionScopedModels(ctx: SessionModelContext, registry: ModelRegistryAdapter): RoutingModel[] | undefined;
12
+ export {};
13
+ //# sourceMappingURL=model-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/model-registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAMN,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,qBAAqB,GAC7B,oBAAoB,CAOtB;AAED,UAAU,mBAAmB;IAC5B,aAAa,EAAE,qBAAqB,CAAC;IACrC,YAAY,CAAC,EAAE,SAAS;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,EAAE,CAAC;CAClD;AAOD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,mBAAmB,EACxB,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,oBAAoB,CAOtB;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,oBAAoB,GAC5B,YAAY,EAAE,GAAG,SAAS,CAS5B"}
@@ -0,0 +1,52 @@
1
+ import { clampThinkingLevel, getSupportedThinkingLevels, } from "@earendil-works/pi-ai";
2
+ import { createModelRegistryAdapter, MODEL_SCOPE_ENV, modelScopeOf, scopeModelRegistryAdapter, sessionModelScope, } from "../../maestro/core/routing.js";
3
+ export function wrapPiModelRegistry(registry) {
4
+ return createModelRegistryAdapter(registry, {
5
+ supportedThinkingLevels: (model) => getSupportedThinkingLevels(asPiModel(model)),
6
+ clampThinkingLevel: (model, level) => clampThinkingLevel(asPiModel(model), level),
7
+ });
8
+ }
9
+ // Scoped sessions (--models / enabledModels) resolve every model selection —
10
+ // task shortlists, exact refs, fallback alternatives — against the session's
11
+ // scoped set: out-of-scope models are invisible to spawn-time resolution. A
12
+ // child also narrows its scope to the exact allowlist its parent exported, and
13
+ // stays scoped to it when its own --models resolved to nothing.
14
+ export function sessionModelRegistry(ctx, env = process.env) {
15
+ const registry = wrapPiModelRegistry(ctx.modelRegistry);
16
+ const ownScope = (ctx.scopedModels ?? []).map(({ model }) => `${model.provider}/${model.id}`);
17
+ const scope = sessionModelScope(ownScope, env[MODEL_SCOPE_ENV]);
18
+ return scope ? scopeModelRegistryAdapter(registry, new Set(scope)) : registry;
19
+ }
20
+ /** The models a scoped session's catalog lists, or undefined when unscoped. */
21
+ export function sessionScopedModels(ctx, registry) {
22
+ const scope = modelScopeOf(registry);
23
+ if (!scope)
24
+ return undefined;
25
+ const inScope = new Set(scope);
26
+ const own = (ctx.scopedModels ?? [])
27
+ .map(({ model }) => model)
28
+ .filter((model) => inScope.has(`${model.provider}/${model.id}`));
29
+ // Only an inherited allowlist applies: list what the registry resolves.
30
+ return own.length > 0 ? own : registry.available();
31
+ }
32
+ function asPiModel(model) {
33
+ return {
34
+ provider: model.provider,
35
+ id: model.id,
36
+ name: model.id,
37
+ api: "openai-completions",
38
+ baseUrl: "",
39
+ reasoning: model.reasoning,
40
+ thinkingLevelMap: model.thinkingLevelMap,
41
+ input: model.input?.filter((entry) => entry === "text" || entry === "image") ?? ["text"],
42
+ contextWindow: model.contextWindow ?? 0,
43
+ maxTokens: model.maxTokens ?? 0,
44
+ cost: {
45
+ input: model.cost?.input ?? 0,
46
+ output: model.cost?.output ?? 0,
47
+ cacheRead: model.cost?.cacheRead ?? 0,
48
+ cacheWrite: model.cost?.cacheWrite ?? 0,
49
+ },
50
+ };
51
+ }
52
+ //# sourceMappingURL=model-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../../pi-extension/subagents/model-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tclampThinkingLevel,\n\tgetSupportedThinkingLevels,\n\ttype Model,\n} from \"@earendil-works/pi-ai\";\nimport {\n\tcreateModelRegistryAdapter,\n\tMODEL_SCOPE_ENV,\n\tmodelScopeOf,\n\tscopeModelRegistryAdapter,\n\tsessionModelScope,\n\ttype ModelRegistryAdapter,\n\ttype RoutingModel,\n\ttype RoutingRegistrySource,\n} from \"../../maestro/core/routing.ts\";\n\nexport function wrapPiModelRegistry(\n\tregistry: RoutingRegistrySource,\n): ModelRegistryAdapter {\n\treturn createModelRegistryAdapter(registry, {\n\t\tsupportedThinkingLevels: (model) =>\n\t\t\tgetSupportedThinkingLevels(asPiModel(model)),\n\t\tclampThinkingLevel: (model, level) =>\n\t\t\tclampThinkingLevel(asPiModel(model), level),\n\t});\n}\n\ninterface SessionModelContext {\n\tmodelRegistry: RoutingRegistrySource;\n\tscopedModels?: readonly { model: RoutingModel }[];\n}\n\n// Scoped sessions (--models / enabledModels) resolve every model selection —\n// task shortlists, exact refs, fallback alternatives — against the session's\n// scoped set: out-of-scope models are invisible to spawn-time resolution. A\n// child also narrows its scope to the exact allowlist its parent exported, and\n// stays scoped to it when its own --models resolved to nothing.\nexport function sessionModelRegistry(\n\tctx: SessionModelContext,\n\tenv: NodeJS.ProcessEnv = process.env,\n): ModelRegistryAdapter {\n\tconst registry = wrapPiModelRegistry(ctx.modelRegistry);\n\tconst ownScope = (ctx.scopedModels ?? []).map(\n\t\t({ model }) => `${model.provider}/${model.id}`,\n\t);\n\tconst scope = sessionModelScope(ownScope, env[MODEL_SCOPE_ENV]);\n\treturn scope ? scopeModelRegistryAdapter(registry, new Set(scope)) : registry;\n}\n\n/** The models a scoped session's catalog lists, or undefined when unscoped. */\nexport function sessionScopedModels(\n\tctx: SessionModelContext,\n\tregistry: ModelRegistryAdapter,\n): RoutingModel[] | undefined {\n\tconst scope = modelScopeOf(registry);\n\tif (!scope) return undefined;\n\tconst inScope = new Set(scope);\n\tconst own = (ctx.scopedModels ?? [])\n\t\t.map(({ model }) => model)\n\t\t.filter((model) => inScope.has(`${model.provider}/${model.id}`));\n\t// Only an inherited allowlist applies: list what the registry resolves.\n\treturn own.length > 0 ? own : registry.available();\n}\n\nfunction asPiModel(model: RoutingModel): Model<any> {\n\treturn {\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tname: model.id,\n\t\tapi: \"openai-completions\",\n\t\tbaseUrl: \"\",\n\t\treasoning: model.reasoning,\n\t\tthinkingLevelMap: model.thinkingLevelMap,\n\t\tinput: model.input?.filter(\n\t\t\t(entry): entry is \"text\" | \"image\" =>\n\t\t\t\tentry === \"text\" || entry === \"image\",\n\t\t) ?? [\"text\"],\n\t\tcontextWindow: model.contextWindow ?? 0,\n\t\tmaxTokens: model.maxTokens ?? 0,\n\t\tcost: {\n\t\t\tinput: model.cost?.input ?? 0,\n\t\t\toutput: model.cost?.output ?? 0,\n\t\t\tcacheRead: model.cost?.cacheRead ?? 0,\n\t\t\tcacheWrite: model.cost?.cacheWrite ?? 0,\n\t\t},\n\t};\n}\n"]}
@@ -0,0 +1,38 @@
1
+ import { type LifecycleProjection, type SubagentLifecycle } from "../../maestro/core/lifecycle.ts";
2
+ import type { NoProgressClassification, NoProgressSessionTail, RunningSubagent, SubagentRuntime } from "./state.ts";
3
+ /**
4
+ * A row as an older version's runtime slot may hold it: it predates the
5
+ * lifecycle model and carries at most a `statusState` snapshot.
6
+ */
7
+ export type AdoptedRow = Omit<RunningSubagent, "lifecycle"> & {
8
+ lifecycle?: SubagentLifecycle;
9
+ };
10
+ /**
11
+ * Give every row of an adopted runtime slot a `lifecycle`, hydrating it from
12
+ * the legacy `statusState`. After this, `RunningSubagent.lifecycle` holds.
13
+ */
14
+ export declare function normalizeAdoptedRows(rows: Iterable<AdoptedRow>): void;
15
+ /** Whether an adopted row has been normalized to a full running row. */
16
+ export declare function isNormalized(row: AdoptedRow): row is RunningSubagent;
17
+ type NoProgressAdvisoryEvent = {
18
+ kind: "warning";
19
+ idleMs: number;
20
+ classification: NoProgressClassification;
21
+ lastEntryKind: NoProgressSessionTail["lastEntryKind"];
22
+ notify: boolean;
23
+ } | {
24
+ kind: "recovered";
25
+ idleMs: number;
26
+ classification: NoProgressClassification;
27
+ lastEntryKind: NoProgressSessionTail["lastEntryKind"];
28
+ notify: boolean;
29
+ };
30
+ export type Observation = ReturnType<typeof createObservation>;
31
+ /** Activity observation bound to one extension instance's runtime. */
32
+ export declare function createObservation(runtime: SubagentRuntime): {
33
+ observeRunningSubagent: (running: RunningSubagent, observedAt?: number) => void;
34
+ evaluateNoProgressAdvisory: (running: RunningSubagent, projection: LifecycleProjection, now: number, hangWarningMinutes: number, inspectProgress?: (running: RunningSubagent) => NoProgressSessionTail) => NoProgressAdvisoryEvent | undefined;
35
+ };
36
+ export declare function formatNoProgressAdvisoryLine(running: RunningSubagent, event: NoProgressAdvisoryEvent): string;
37
+ export {};
38
+ //# sourceMappingURL=observation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/observation.ts"],"names":[],"mappings":"AAYA,OAAO,EAMN,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACX,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG;IAC7D,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAErE;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,GAAG,IAAI,eAAe,CAEpE;AA8DD,KAAK,uBAAuB,GACzB;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,wBAAwB,CAAC;IACzC,aAAa,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,EAAE,OAAO,CAAC;CACf,GACD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,wBAAwB,CAAC;IACzC,aAAa,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,EAAE,OAAO,CAAC;CACf,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE/D,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe;sCAE/C,eAAe;0CA2Bf,eAAe,cACZ,mBAAmB,OAC1B,MAAM,sBACS,MAAM,oBACT,CAAC,OAAO,EAAE,eAAe,KAAK,qBAAqB,KAQlE,uBAAuB,GAAG,SAAS;EAyDtC;AAED,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,uBAAuB,GAC5B,MAAM,CAoBR"}
@@ -0,0 +1,168 @@
1
+ import { encodeHostValue, HOST_PATH_CHARS, } from "../../maestro/core/host-text.js";
2
+ import { statSync } from "node:fs";
3
+ import { observePiActivity } from "../../maestro/runtime/index.js";
4
+ import { formatElapsedDuration, normalizeStatusName, } from "../../maestro/core/status.js";
5
+ import { isSubagentActivityScope } from "../../maestro/core/activity.js";
6
+ import { createLifecycle, markInterruptRequested, markProcessRunning, observeActivity, observePaneInspection, } from "../../maestro/core/lifecycle.js";
7
+ /**
8
+ * Give every row of an adopted runtime slot a `lifecycle`, hydrating it from
9
+ * the legacy `statusState`. After this, `RunningSubagent.lifecycle` holds.
10
+ */
11
+ export function normalizeAdoptedRows(rows) {
12
+ for (const row of rows)
13
+ hydrateLifecycle(row);
14
+ }
15
+ /** Whether an adopted row has been normalized to a full running row. */
16
+ export function isNormalized(row) {
17
+ return row.lifecycle !== undefined;
18
+ }
19
+ function hydrateLifecycle(running) {
20
+ if (running.lifecycle)
21
+ return running.lifecycle;
22
+ let lifecycle = createLifecycle(running.startTime);
23
+ const state = running.statusState;
24
+ if (state?.activityLabel === "interrupted" &&
25
+ state.localOverrideAtMs != null) {
26
+ lifecycle = markInterruptRequested(lifecycle, state.localOverrideAtMs);
27
+ }
28
+ else if (state?.phase === "done") {
29
+ // Legacy activity "done" means the turn ended, not that completion
30
+ // evidence was recorded. Hydrate as Herdr-style waiting and let the
31
+ // preserved watcher consume sidecar/sentinel evidence.
32
+ const observedAt = state.lastActivityAtMs ?? running.startTime;
33
+ lifecycle = observePaneInspection(lifecycle, { kind: "present", observedAt, agentStatus: "done" }, observedAt);
34
+ }
35
+ else if (state?.phase === "active" ||
36
+ state?.phase === "waiting" ||
37
+ state?.phase === "starting") {
38
+ const activity = {
39
+ version: 1,
40
+ runningChildId: running.id,
41
+ createdAt: running.startTime,
42
+ updatedAt: state.lastActivityAtMs ?? running.startTime,
43
+ sequence: state.lastActivitySequence ?? 0,
44
+ latestEvent: state.latestEvent === "agent_end" ? "agent_end" : "agent_start",
45
+ phase: state.phase,
46
+ agentActive: state.phase === "active",
47
+ turnActive: state.phase === "active",
48
+ providerActive: false,
49
+ toolActive: state.activeScope === "tool",
50
+ };
51
+ if (isSubagentActivityScope(state.activeScope)) {
52
+ activity.activeScope = state.activeScope;
53
+ }
54
+ if (state.activeSinceMs != null)
55
+ activity.activeSince = state.activeSinceMs;
56
+ if (state.waitingSinceMs != null)
57
+ activity.waitingSince = state.waitingSinceMs;
58
+ if (state.activityLabel && state.activeScope === "tool") {
59
+ activity.toolName = state.activityLabel;
60
+ }
61
+ lifecycle = observeActivity(lifecycle, { ok: true, activity }, state.lastActivityAtMs ?? running.startTime);
62
+ }
63
+ else if (running.startTime) {
64
+ // Pre-lifecycle Pi agents without a known phase still get a running process.
65
+ lifecycle = markProcessRunning(lifecycle, running.startTime);
66
+ }
67
+ running.lifecycle = lifecycle;
68
+ return lifecycle;
69
+ }
70
+ /** Activity observation bound to one extension instance's runtime. */
71
+ export function createObservation(runtime) {
72
+ function observeRunningSubagent(running, observedAt = Date.now()) {
73
+ const control = runtime.session?.getControlTaskId(running.id);
74
+ if (control) {
75
+ runtime.session.observe(control, observedAt);
76
+ return;
77
+ }
78
+ const observation = observePiActivity({
79
+ id: running.id,
80
+ activityFile: running.activityFile,
81
+ lifecycle: running.lifecycle,
82
+ }, observedAt);
83
+ const read = observation.activityRead;
84
+ running.activityRead = read.ok
85
+ ? { ok: true }
86
+ : { ok: false, reason: read.reason, error: read.error };
87
+ if (read.ok)
88
+ running.activity = read.activity;
89
+ running.lifecycle = observation.lifecycle;
90
+ }
91
+ function evaluateNoProgressAdvisory(running, projection, now, hangWarningMinutes, inspectProgress = (running) => {
92
+ const control = runtime.session?.getControlTaskId(running.id);
93
+ return control
94
+ ? runtime.session.inspectProgress(control)
95
+ : { classification: "generic-no-progress", lastEntryKind: "other" };
96
+ }) {
97
+ if (hangWarningMinutes === 0) {
98
+ delete running.noProgressEpisode;
99
+ return;
100
+ }
101
+ if (projection.kind !== "active" && projection.kind !== "blocked") {
102
+ delete running.noProgressEpisode;
103
+ return;
104
+ }
105
+ let sessionMtime;
106
+ try {
107
+ sessionMtime = statSync(running.sessionFile).mtimeMs;
108
+ }
109
+ catch {
110
+ // Session evidence is unavailable; do not turn that I/O problem into a hang.
111
+ return;
112
+ }
113
+ const progressAt = Math.min(now, Math.max(sessionMtime, running.activity?.updatedAt ?? Number.NEGATIVE_INFINITY));
114
+ const idleMs = Math.max(0, now - progressAt);
115
+ if (idleMs <= hangWarningMinutes * 60_000) {
116
+ const previous = running.noProgressEpisode;
117
+ delete running.noProgressEpisode;
118
+ return previous
119
+ ? {
120
+ kind: "recovered",
121
+ idleMs: Math.max(0, now - previous.progressAt),
122
+ classification: previous.classification,
123
+ lastEntryKind: previous.lastEntryKind,
124
+ notify: !running.interactive,
125
+ }
126
+ : undefined;
127
+ }
128
+ if (running.noProgressEpisode)
129
+ return;
130
+ let tail = {
131
+ classification: "generic-no-progress",
132
+ lastEntryKind: "other",
133
+ };
134
+ try {
135
+ // The bounded reader is deliberately cold-path only: mtime/snapshot checks
136
+ // above run on every refresh, but JSONL parsing happens once per episode.
137
+ tail = inspectProgress(running);
138
+ }
139
+ catch {
140
+ // A session can disappear between stat and read; preserve a facts-only
141
+ // generic advisory rather than failing the status loop.
142
+ }
143
+ running.noProgressEpisode = { active: true, progressAt, idleMs, ...tail };
144
+ return { kind: "warning", idleMs, ...tail, notify: !running.interactive };
145
+ }
146
+ return { observeRunningSubagent, evaluateNoProgressAdvisory };
147
+ }
148
+ export function formatNoProgressAdvisoryLine(running, event) {
149
+ const name = encodeHostValue(normalizeStatusName(running.name));
150
+ const persistentIds = running.persistent
151
+ ? ` Logical ID: ${encodeHostValue(running.logicalId ?? "unknown")}; generation ID: ${encodeHostValue(running.generationId ?? "unknown")}.`
152
+ : "";
153
+ if (event.kind === "recovered") {
154
+ return `${name} no-progress advisory recovered after ${formatElapsedDuration(event.idleMs)}.${persistentIds}`;
155
+ }
156
+ const classification = event.classification === "blocked-tool"
157
+ ? "blocked-tool; the outstanding tool may still complete"
158
+ : event.classification === "truncated-turn"
159
+ ? "truncated-turn; observed toolUse stop with no tool call; cause unknown"
160
+ : "generic no-progress";
161
+ const options = running.worktree
162
+ ? "interrupt, or retain the workspace and continue there after confirming the previous process exited"
163
+ : running.persistent
164
+ ? "interrupt, or use subagent_stop then replace with a new persistent specialist"
165
+ : "interrupt, or after manual termination use subagent_resume or a new spawn";
166
+ return `${name} no-progress advisory: ${formatElapsedDuration(event.idleMs)} idle while active. Classification: ${classification}. Last entry: ${encodeHostValue(event.lastEntryKind)}. Session: ${encodeHostValue(running.sessionFile, HOST_PATH_CHARS)}. Recovery options: ${options}.${persistentIds}`;
167
+ }
168
+ //# sourceMappingURL=observation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../pi-extension/subagents/observation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tencodeHostValue,\n\tHOST_PATH_CHARS,\n} from \"../../maestro/core/host-text.ts\";\nimport { statSync } from \"node:fs\";\nimport { observePiActivity } from \"../../maestro/runtime/index.ts\";\nimport {\n\tformatElapsedDuration,\n\tnormalizeStatusName,\n} from \"../../maestro/core/status.ts\";\nimport { isSubagentActivityScope } from \"../../maestro/core/activity.ts\";\nimport type { SubagentActivityState } from \"../../maestro/core/types.ts\";\nimport {\n\tcreateLifecycle,\n\tmarkInterruptRequested,\n\tmarkProcessRunning,\n\tobserveActivity,\n\tobservePaneInspection,\n\ttype LifecycleProjection,\n\ttype SubagentLifecycle,\n} from \"../../maestro/core/lifecycle.ts\";\nimport type {\n\tNoProgressClassification,\n\tNoProgressSessionTail,\n\tRunningSubagent,\n\tSubagentRuntime,\n} from \"./state.ts\";\n\n/**\n * A row as an older version's runtime slot may hold it: it predates the\n * lifecycle model and carries at most a `statusState` snapshot.\n */\nexport type AdoptedRow = Omit<RunningSubagent, \"lifecycle\"> & {\n\tlifecycle?: SubagentLifecycle;\n};\n\n/**\n * Give every row of an adopted runtime slot a `lifecycle`, hydrating it from\n * the legacy `statusState`. After this, `RunningSubagent.lifecycle` holds.\n */\nexport function normalizeAdoptedRows(rows: Iterable<AdoptedRow>): void {\n\tfor (const row of rows) hydrateLifecycle(row);\n}\n\n/** Whether an adopted row has been normalized to a full running row. */\nexport function isNormalized(row: AdoptedRow): row is RunningSubagent {\n\treturn row.lifecycle !== undefined;\n}\n\nfunction hydrateLifecycle(running: AdoptedRow): SubagentLifecycle {\n\tif (running.lifecycle) return running.lifecycle;\n\tlet lifecycle = createLifecycle(running.startTime);\n\tconst state = running.statusState;\n\tif (\n\t\tstate?.activityLabel === \"interrupted\" &&\n\t\tstate.localOverrideAtMs != null\n\t) {\n\t\tlifecycle = markInterruptRequested(lifecycle, state.localOverrideAtMs);\n\t} else if (state?.phase === \"done\") {\n\t\t// Legacy activity \"done\" means the turn ended, not that completion\n\t\t// evidence was recorded. Hydrate as Herdr-style waiting and let the\n\t\t// preserved watcher consume sidecar/sentinel evidence.\n\t\tconst observedAt = state.lastActivityAtMs ?? running.startTime;\n\t\tlifecycle = observePaneInspection(\n\t\t\tlifecycle,\n\t\t\t{ kind: \"present\", observedAt, agentStatus: \"done\" },\n\t\t\tobservedAt,\n\t\t);\n\t} else if (\n\t\tstate?.phase === \"active\" ||\n\t\tstate?.phase === \"waiting\" ||\n\t\tstate?.phase === \"starting\"\n\t) {\n\t\tconst activity: SubagentActivityState = {\n\t\t\tversion: 1,\n\t\t\trunningChildId: running.id,\n\t\t\tcreatedAt: running.startTime,\n\t\t\tupdatedAt: state.lastActivityAtMs ?? running.startTime,\n\t\t\tsequence: state.lastActivitySequence ?? 0,\n\t\t\tlatestEvent:\n\t\t\t\tstate.latestEvent === \"agent_end\" ? \"agent_end\" : \"agent_start\",\n\t\t\tphase: state.phase,\n\t\t\tagentActive: state.phase === \"active\",\n\t\t\tturnActive: state.phase === \"active\",\n\t\t\tproviderActive: false,\n\t\t\ttoolActive: state.activeScope === \"tool\",\n\t\t};\n\t\tif (isSubagentActivityScope(state.activeScope)) {\n\t\t\tactivity.activeScope = state.activeScope;\n\t\t}\n\t\tif (state.activeSinceMs != null) activity.activeSince = state.activeSinceMs;\n\t\tif (state.waitingSinceMs != null)\n\t\t\tactivity.waitingSince = state.waitingSinceMs;\n\t\tif (state.activityLabel && state.activeScope === \"tool\") {\n\t\t\tactivity.toolName = state.activityLabel;\n\t\t}\n\t\tlifecycle = observeActivity(\n\t\t\tlifecycle,\n\t\t\t{ ok: true, activity },\n\t\t\tstate.lastActivityAtMs ?? running.startTime,\n\t\t);\n\t} else if (running.startTime) {\n\t\t// Pre-lifecycle Pi agents without a known phase still get a running process.\n\t\tlifecycle = markProcessRunning(lifecycle, running.startTime);\n\t}\n\trunning.lifecycle = lifecycle;\n\treturn lifecycle;\n}\n\ntype NoProgressAdvisoryEvent =\n\t| {\n\t\t\tkind: \"warning\";\n\t\t\tidleMs: number;\n\t\t\tclassification: NoProgressClassification;\n\t\t\tlastEntryKind: NoProgressSessionTail[\"lastEntryKind\"];\n\t\t\tnotify: boolean;\n\t }\n\t| {\n\t\t\tkind: \"recovered\";\n\t\t\tidleMs: number;\n\t\t\tclassification: NoProgressClassification;\n\t\t\tlastEntryKind: NoProgressSessionTail[\"lastEntryKind\"];\n\t\t\tnotify: boolean;\n\t };\n\nexport type Observation = ReturnType<typeof createObservation>;\n\n/** Activity observation bound to one extension instance's runtime. */\nexport function createObservation(runtime: SubagentRuntime) {\n\tfunction observeRunningSubagent(\n\t\trunning: RunningSubagent,\n\t\tobservedAt = Date.now(),\n\t) {\n\t\tconst control = runtime.session?.getControlTaskId(running.id);\n\t\tif (control) {\n\t\t\truntime.session!.observe(control, observedAt);\n\t\t\treturn;\n\t\t}\n\t\tconst observation = observePiActivity(\n\t\t\t{\n\t\t\t\tid: running.id,\n\t\t\t\tactivityFile: running.activityFile,\n\t\t\t\tlifecycle: running.lifecycle,\n\t\t\t},\n\t\t\tobservedAt,\n\t\t);\n\t\tconst read = observation.activityRead;\n\n\t\trunning.activityRead = read.ok\n\t\t\t? { ok: true }\n\t\t\t: { ok: false, reason: read.reason, error: read.error };\n\n\t\tif (read.ok) running.activity = read.activity;\n\t\trunning.lifecycle = observation.lifecycle;\n\t}\n\n\tfunction evaluateNoProgressAdvisory(\n\t\trunning: RunningSubagent,\n\t\tprojection: LifecycleProjection,\n\t\tnow: number,\n\t\thangWarningMinutes: number,\n\t\tinspectProgress: (running: RunningSubagent) => NoProgressSessionTail = (\n\t\t\trunning,\n\t\t) => {\n\t\t\tconst control = runtime.session?.getControlTaskId(running.id);\n\t\t\treturn control\n\t\t\t\t? runtime.session!.inspectProgress(control)\n\t\t\t\t: { classification: \"generic-no-progress\", lastEntryKind: \"other\" };\n\t\t},\n\t): NoProgressAdvisoryEvent | undefined {\n\t\tif (hangWarningMinutes === 0) {\n\t\t\tdelete running.noProgressEpisode;\n\t\t\treturn;\n\t\t}\n\t\tif (projection.kind !== \"active\" && projection.kind !== \"blocked\") {\n\t\t\tdelete running.noProgressEpisode;\n\t\t\treturn;\n\t\t}\n\n\t\tlet sessionMtime: number;\n\t\ttry {\n\t\t\tsessionMtime = statSync(running.sessionFile).mtimeMs;\n\t\t} catch {\n\t\t\t// Session evidence is unavailable; do not turn that I/O problem into a hang.\n\t\t\treturn;\n\t\t}\n\t\tconst progressAt = Math.min(\n\t\t\tnow,\n\t\t\tMath.max(\n\t\t\t\tsessionMtime,\n\t\t\t\trunning.activity?.updatedAt ?? Number.NEGATIVE_INFINITY,\n\t\t\t),\n\t\t);\n\t\tconst idleMs = Math.max(0, now - progressAt);\n\t\tif (idleMs <= hangWarningMinutes * 60_000) {\n\t\t\tconst previous = running.noProgressEpisode;\n\t\t\tdelete running.noProgressEpisode;\n\t\t\treturn previous\n\t\t\t\t? {\n\t\t\t\t\t\tkind: \"recovered\",\n\t\t\t\t\t\tidleMs: Math.max(0, now - previous.progressAt),\n\t\t\t\t\t\tclassification: previous.classification,\n\t\t\t\t\t\tlastEntryKind: previous.lastEntryKind,\n\t\t\t\t\t\tnotify: !running.interactive,\n\t\t\t\t\t}\n\t\t\t\t: undefined;\n\t\t}\n\t\tif (running.noProgressEpisode) return;\n\n\t\tlet tail: NoProgressSessionTail = {\n\t\t\tclassification: \"generic-no-progress\",\n\t\t\tlastEntryKind: \"other\",\n\t\t};\n\t\ttry {\n\t\t\t// The bounded reader is deliberately cold-path only: mtime/snapshot checks\n\t\t\t// above run on every refresh, but JSONL parsing happens once per episode.\n\t\t\ttail = inspectProgress(running);\n\t\t} catch {\n\t\t\t// A session can disappear between stat and read; preserve a facts-only\n\t\t\t// generic advisory rather than failing the status loop.\n\t\t}\n\t\trunning.noProgressEpisode = { active: true, progressAt, idleMs, ...tail };\n\t\treturn { kind: \"warning\", idleMs, ...tail, notify: !running.interactive };\n\t}\n\n\treturn { observeRunningSubagent, evaluateNoProgressAdvisory };\n}\n\nexport function formatNoProgressAdvisoryLine(\n\trunning: RunningSubagent,\n\tevent: NoProgressAdvisoryEvent,\n): string {\n\tconst name = encodeHostValue(normalizeStatusName(running.name));\n\tconst persistentIds = running.persistent\n\t\t? ` Logical ID: ${encodeHostValue(running.logicalId ?? \"unknown\")}; generation ID: ${encodeHostValue(running.generationId ?? \"unknown\")}.`\n\t\t: \"\";\n\tif (event.kind === \"recovered\") {\n\t\treturn `${name} no-progress advisory recovered after ${formatElapsedDuration(event.idleMs)}.${persistentIds}`;\n\t}\n\tconst classification =\n\t\tevent.classification === \"blocked-tool\"\n\t\t\t? \"blocked-tool; the outstanding tool may still complete\"\n\t\t\t: event.classification === \"truncated-turn\"\n\t\t\t\t? \"truncated-turn; observed toolUse stop with no tool call; cause unknown\"\n\t\t\t\t: \"generic no-progress\";\n\tconst options = running.worktree\n\t\t? \"interrupt, or retain the workspace and continue there after confirming the previous process exited\"\n\t\t: running.persistent\n\t\t\t? \"interrupt, or use subagent_stop then replace with a new persistent specialist\"\n\t\t\t: \"interrupt, or after manual termination use subagent_resume or a new spawn\";\n\treturn `${name} no-progress advisory: ${formatElapsedDuration(event.idleMs)} idle while active. Classification: ${classification}. Last entry: ${encodeHostValue(event.lastEntryKind)}. Session: ${encodeHostValue(running.sessionFile, HOST_PATH_CHARS)}. Recovery options: ${options}.${persistentIds}`;\n}\n"]}
@@ -0,0 +1,72 @@
1
+ import type { AgentToolResult, ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import type { PiRunRecord, PiPersistentIO } from "../../maestro/runtime/index.ts";
3
+ import type { PersistentConfig } from "../../maestro/core/config/persistent-config.ts";
4
+ import type { WorktreeHandoff } from "../../maestro/core/worktree.ts";
5
+ import { type RunningSubagent, type SubagentRuntime } from "./state.ts";
6
+ import type { Controls } from "./controls.ts";
7
+ import { type HostField } from "./presentation.ts";
8
+ export declare function asPiRecord(running: RunningSubagent): PiRunRecord;
9
+ export declare function persistentSpecialistState(running: RunningSubagent): "idle" | "working" | "stalled" | "stopped";
10
+ export interface SubagentSendDetails {
11
+ error?: string;
12
+ id?: string;
13
+ task?: string;
14
+ inbox?: string;
15
+ outcome?: "dispatched" | "rejected-busy";
16
+ }
17
+ interface PersistentSpecialistFacts {
18
+ logicalId: string;
19
+ generationId: string;
20
+ policyHash: string;
21
+ tasks: Array<{
22
+ task: string;
23
+ outcome: string;
24
+ }>;
25
+ sessionFile: string;
26
+ worktree?: WorktreeHandoff;
27
+ lastObservedPhase: string;
28
+ }
29
+ export declare function persistentSpecialistFacts(running: RunningSubagent, io: PiPersistentIO, worktree?: WorktreeHandoff): PersistentSpecialistFacts;
30
+ /**
31
+ * Facts for a crash or stop notice. The ledger is child-writable, so its
32
+ * outcomes are one bounded list of encoded entries with an omitted count;
33
+ * details keep every entry.
34
+ */
35
+ export declare function persistentFactsFields(facts: PersistentSpecialistFacts): HostField[];
36
+ export interface SubagentStopDetails {
37
+ error?: string;
38
+ id?: string;
39
+ name?: string;
40
+ status?: "stop_requested" | "stop_pending";
41
+ }
42
+ interface PersistentControlDeps {
43
+ runtime: SubagentRuntime;
44
+ persistentConfig: PersistentConfig;
45
+ resolveInterruptTarget: Controls["resolveInterruptTarget"];
46
+ }
47
+ export type PersistentControls = ReturnType<typeof createPersistentControls>;
48
+ /** Persistent specialist controls bound to one extension instance. */
49
+ export declare function createPersistentControls({ runtime, persistentConfig, resolveInterruptTarget, }: PersistentControlDeps): {
50
+ formatLivePersistentSpecialists: () => string[];
51
+ resolvePersistentTarget: (params: {
52
+ id?: string;
53
+ name?: string;
54
+ }) => {
55
+ running: RunningSubagent;
56
+ } | {
57
+ error: string;
58
+ };
59
+ persistentCapacityError: (config?: PersistentConfig) => string | undefined;
60
+ startPersistentStopTimeout: (running: RunningSubagent, _api: Pick<ExtensionAPI, "sendMessage">, stopTimeoutMs: number | undefined, io: PiPersistentIO) => void;
61
+ handleSubagentStop: (params: {
62
+ id?: string;
63
+ name?: string;
64
+ }, api: Pick<ExtensionAPI, "sendMessage">, stopTimeoutMs: number | undefined, io: PiPersistentIO) => AgentToolResult<SubagentStopDetails>;
65
+ handleSubagentSend: (params: {
66
+ id?: string;
67
+ name?: string;
68
+ message: string;
69
+ }, io: PiPersistentIO) => AgentToolResult<SubagentSendDetails>;
70
+ };
71
+ export {};
72
+ //# sourceMappingURL=persistent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistent.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/persistent.ts"],"names":[],"mappings":"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"}