@xzzpig/pi-subagents 0.21.0 → 0.24.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 (1132) hide show
  1. package/CHANGELOG.md +356 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/fork-supervisor-routing.md +77 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -86
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1288 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/inspectors/actions.d.ts +24 -0
  196. package/src/inspectors/actions.js +182 -0
  197. package/src/inspectors/ghostty/actions.d.ts +11 -0
  198. package/src/inspectors/ghostty/actions.js +62 -0
  199. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  200. package/src/inspectors/ghostty/plugin.js +23 -0
  201. package/src/inspectors/herdr/actions.d.ts +25 -0
  202. package/src/inspectors/herdr/actions.js +133 -0
  203. package/src/inspectors/herdr/client.d.ts +41 -0
  204. package/src/inspectors/herdr/client.js +129 -0
  205. package/src/inspectors/herdr/focus.d.ts +24 -0
  206. package/src/inspectors/herdr/focus.js +49 -0
  207. package/src/inspectors/herdr/plugin.d.ts +6 -0
  208. package/src/inspectors/herdr/plugin.js +14 -0
  209. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  210. package/src/inspectors/herdr/project-panes.js +610 -0
  211. package/src/inspectors/inspector-runner.d.ts +23 -0
  212. package/src/inspectors/inspector-runner.js +161 -0
  213. package/src/inspectors/plugins.d.ts +8 -0
  214. package/src/inspectors/plugins.js +82 -0
  215. package/src/inspectors/session-roots-codec.d.ts +15 -0
  216. package/src/inspectors/session-roots-codec.js +32 -0
  217. package/src/inspectors/shell-command.d.ts +1 -0
  218. package/src/inspectors/shell-command.js +16 -0
  219. package/src/inspectors/tmux/actions.d.ts +25 -0
  220. package/src/inspectors/tmux/actions.js +181 -0
  221. package/src/inspectors/tmux/client.d.ts +27 -0
  222. package/src/inspectors/tmux/client.js +64 -0
  223. package/src/inspectors/tmux/plugin.d.ts +7 -0
  224. package/src/inspectors/tmux/plugin.js +14 -0
  225. package/src/inspectors/types.d.ts +48 -0
  226. package/src/inspectors/types.js +1 -0
  227. package/src/integrations/herdr-status.d.ts +47 -0
  228. package/src/integrations/herdr-status.js +350 -0
  229. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  230. package/src/integrations/pi-web-session-liveness.js +53 -0
  231. package/src/integrations/program-status.d.ts +30 -0
  232. package/src/integrations/program-status.js +188 -0
  233. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  234. package/src/intercom/fork-supervisor-routing.js +392 -0
  235. package/src/intercom/intercom-bridge.d.ts +58 -0
  236. package/src/intercom/intercom-bridge.js +193 -0
  237. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  238. package/src/intercom/native-supervisor-channel.js +1184 -0
  239. package/src/intercom/result-intercom.d.ts +35 -0
  240. package/src/intercom/result-intercom.js +376 -0
  241. package/src/intercom/supervisor-ui.d.ts +29 -0
  242. package/src/intercom/supervisor-ui.js +49 -0
  243. package/src/missions/actions.d.ts +54 -0
  244. package/src/missions/actions.js +400 -0
  245. package/src/missions/goal-driver.d.ts +16 -0
  246. package/src/missions/goal-driver.js +171 -0
  247. package/src/missions/lifecycle.d.ts +50 -0
  248. package/src/missions/lifecycle.js +388 -0
  249. package/src/missions/store.d.ts +21 -0
  250. package/src/missions/store.js +605 -0
  251. package/src/missions/types.d.ts +169 -0
  252. package/src/missions/types.js +9 -0
  253. package/src/missions/workflow-state.d.ts +14 -0
  254. package/src/missions/workflow-state.js +273 -0
  255. package/src/policy/authority.d.ts +9 -0
  256. package/src/policy/authority.js +41 -0
  257. package/src/profiles/profiles.d.ts +134 -0
  258. package/src/profiles/profiles.js +526 -0
  259. package/src/runs/background/active-async-capacity.d.ts +115 -0
  260. package/src/runs/background/active-async-capacity.js +517 -0
  261. package/src/runs/background/active-run-index.d.ts +12 -0
  262. package/src/runs/background/active-run-index.js +157 -0
  263. package/src/runs/background/async-execution.d.ts +304 -0
  264. package/src/runs/background/async-execution.js +2206 -0
  265. package/src/runs/background/async-job-tracker.d.ts +37 -0
  266. package/src/runs/background/async-job-tracker.js +921 -0
  267. package/src/runs/background/async-resume.d.ts +60 -0
  268. package/src/runs/background/async-resume.js +707 -0
  269. package/src/runs/background/async-retention.d.ts +45 -0
  270. package/src/runs/background/async-retention.js +932 -0
  271. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  272. package/src/runs/background/async-status-snapshot.js +26 -0
  273. package/src/runs/background/async-status.d.ts +177 -0
  274. package/src/runs/background/async-status.js +710 -0
  275. package/src/runs/background/auto-drain.d.ts +16 -0
  276. package/src/runs/background/auto-drain.js +71 -0
  277. package/src/runs/background/await-async-run.d.ts +26 -0
  278. package/src/runs/background/await-async-run.js +83 -0
  279. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  280. package/src/runs/background/binary-bootstrap.js +69 -0
  281. package/src/runs/background/boot-id.d.ts +12 -0
  282. package/src/runs/background/boot-id.js +47 -0
  283. package/src/runs/background/calendar-schedule.d.ts +26 -0
  284. package/src/runs/background/calendar-schedule.js +93 -0
  285. package/src/runs/background/chain-append.d.ts +34 -0
  286. package/src/runs/background/chain-append.js +299 -0
  287. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  288. package/src/runs/background/chain-root-attachment.js +186 -0
  289. package/src/runs/background/completion-batcher.d.ts +51 -0
  290. package/src/runs/background/completion-batcher.js +119 -0
  291. package/src/runs/background/completion-dedupe.d.ts +13 -0
  292. package/src/runs/background/completion-dedupe.js +48 -0
  293. package/src/runs/background/completion-replay.d.ts +47 -0
  294. package/src/runs/background/completion-replay.js +266 -0
  295. package/src/runs/background/control-channel.d.ts +170 -0
  296. package/src/runs/background/control-channel.js +610 -0
  297. package/src/runs/background/fleet-view.d.ts +63 -0
  298. package/src/runs/background/fleet-view.js +666 -0
  299. package/src/runs/background/index-segment.d.ts +16 -0
  300. package/src/runs/background/index-segment.js +58 -0
  301. package/src/runs/background/inspect-rpc.d.ts +64 -0
  302. package/src/runs/background/inspect-rpc.js +422 -0
  303. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  304. package/src/runs/background/interrupted-elsewhere.js +68 -0
  305. package/src/runs/background/notify.d.ts +214 -0
  306. package/src/runs/background/notify.js +1001 -0
  307. package/src/runs/background/owned-process-tree.d.ts +10 -0
  308. package/src/runs/background/owned-process-tree.js +116 -0
  309. package/src/runs/background/parallel-groups.d.ts +3 -0
  310. package/src/runs/background/parallel-groups.js +46 -0
  311. package/src/runs/background/pid-namespace.d.ts +2 -0
  312. package/src/runs/background/pid-namespace.js +19 -0
  313. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  314. package/src/runs/background/process-terminal-candidate.js +96 -0
  315. package/src/runs/background/process-terminal.d.ts +21 -0
  316. package/src/runs/background/process-terminal.js +227 -0
  317. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  318. package/src/runs/background/result-delivery-ownership.js +38 -0
  319. package/src/runs/background/result-files.d.ts +63 -0
  320. package/src/runs/background/result-files.js +629 -0
  321. package/src/runs/background/result-watcher.d.ts +92 -0
  322. package/src/runs/background/result-watcher.js +819 -0
  323. package/src/runs/background/resume-guidance.d.ts +4 -0
  324. package/src/runs/background/resume-guidance.js +57 -0
  325. package/src/runs/background/retained-children.d.ts +24 -0
  326. package/src/runs/background/retained-children.js +128 -0
  327. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  328. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  329. package/src/runs/background/run-child-session.d.ts +123 -0
  330. package/src/runs/background/run-child-session.js +670 -0
  331. package/src/runs/background/run-id-query.d.ts +3 -0
  332. package/src/runs/background/run-id-query.js +6 -0
  333. package/src/runs/background/run-id-resolver.d.ts +22 -0
  334. package/src/runs/background/run-id-resolver.js +172 -0
  335. package/src/runs/background/run-status.d.ts +25 -0
  336. package/src/runs/background/run-status.js +850 -0
  337. package/src/runs/background/runner-aliases.d.ts +17 -0
  338. package/src/runs/background/runner-aliases.js +191 -0
  339. package/src/runs/background/runner-child-launch.d.ts +24 -0
  340. package/src/runs/background/runner-child-launch.js +72 -0
  341. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  342. package/src/runs/background/runner-child-sessions.js +34 -0
  343. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  344. package/src/runs/background/runner-http-dispatcher.js +115 -0
  345. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  346. package/src/runs/background/runner-startup-failure.js +46 -0
  347. package/src/runs/background/scheduled-runs.d.ts +127 -0
  348. package/src/runs/background/scheduled-runs.js +1265 -0
  349. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  350. package/src/runs/background/stale-run-reconciler.js +509 -0
  351. package/src/runs/background/steering.d.ts +51 -0
  352. package/src/runs/background/steering.js +246 -0
  353. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  354. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  355. package/src/runs/background/subagent-runner.d.ts +210 -0
  356. package/src/runs/background/subagent-runner.js +4963 -0
  357. package/src/runs/background/subagent-wait.d.ts +124 -0
  358. package/src/runs/background/subagent-wait.js +756 -0
  359. package/src/runs/background/terminal-run-index.d.ts +10 -0
  360. package/src/runs/background/terminal-run-index.js +209 -0
  361. package/src/runs/background/top-level-async.d.ts +7 -0
  362. package/src/runs/background/top-level-async.js +5 -0
  363. package/src/runs/background/wait-completions.d.ts +28 -0
  364. package/src/runs/background/wait-completions.js +264 -0
  365. package/src/runs/background/wait-config.d.ts +8 -0
  366. package/src/runs/background/wait-config.js +46 -0
  367. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  368. package/src/runs/background/wait-subscriptions.js +339 -0
  369. package/src/runs/background/wait-tool.d.ts +6 -0
  370. package/src/runs/background/wait-tool.js +48 -0
  371. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  372. package/src/runs/background/workflow-terminal-proof.js +116 -0
  373. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  374. package/src/runs/foreground/async-dismiss-action.js +82 -0
  375. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  376. package/src/runs/foreground/async-steering-action.js +294 -0
  377. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  378. package/src/runs/foreground/async-stop-action.js +213 -0
  379. package/src/runs/foreground/command-action.d.ts +12 -0
  380. package/src/runs/foreground/command-action.js +38 -0
  381. package/src/runs/foreground/execution.d.ts +10 -0
  382. package/src/runs/foreground/execution.js +2322 -0
  383. package/src/runs/foreground/foreground-control.d.ts +24 -0
  384. package/src/runs/foreground/foreground-control.js +138 -0
  385. package/src/runs/foreground/foreground-history.d.ts +25 -0
  386. package/src/runs/foreground/foreground-history.js +267 -0
  387. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  388. package/src/runs/foreground/prompt-audit.js +138 -0
  389. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  390. package/src/runs/foreground/subagent-executor.js +7986 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  392. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  393. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  394. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  395. package/src/runs/shared/abort-recovery.d.ts +26 -0
  396. package/src/runs/shared/abort-recovery.js +108 -0
  397. package/src/runs/shared/acceptance.d.ts +144 -0
  398. package/src/runs/shared/acceptance.js +1616 -0
  399. package/src/runs/shared/agent-contract.d.ts +5 -0
  400. package/src/runs/shared/agent-contract.js +35 -0
  401. package/src/runs/shared/async-status-projection.d.ts +100 -0
  402. package/src/runs/shared/async-status-projection.js +566 -0
  403. package/src/runs/shared/background-process-options.d.ts +4 -0
  404. package/src/runs/shared/background-process-options.js +6 -0
  405. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  406. package/src/runs/shared/capability-ceiling.js +179 -0
  407. package/src/runs/shared/chain-outputs.d.ts +18 -0
  408. package/src/runs/shared/chain-outputs.js +104 -0
  409. package/src/runs/shared/child-commands.d.ts +29 -0
  410. package/src/runs/shared/child-commands.js +254 -0
  411. package/src/runs/shared/child-hooks.d.ts +31 -0
  412. package/src/runs/shared/child-hooks.js +173 -0
  413. package/src/runs/shared/child-identity.d.ts +23 -0
  414. package/src/runs/shared/child-identity.js +40 -0
  415. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  416. package/src/runs/shared/child-launch-plan.js +88 -0
  417. package/src/runs/shared/child-launch.d.ts +128 -0
  418. package/src/runs/shared/child-launch.js +262 -0
  419. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  420. package/src/runs/shared/child-lifecycle.js +22 -0
  421. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  422. package/src/runs/shared/child-runtime-config.js +44 -0
  423. package/src/runs/shared/child-session.d.ts +178 -0
  424. package/src/runs/shared/child-session.js +726 -0
  425. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  426. package/src/runs/shared/child-tool-plan.js +430 -0
  427. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  428. package/src/runs/shared/claude-code-adapter.js +255 -0
  429. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  430. package/src/runs/shared/codex-exec-adapter.js +127 -0
  431. package/src/runs/shared/context-mode.d.ts +12 -0
  432. package/src/runs/shared/context-mode.js +38 -0
  433. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  434. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  435. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  436. package/src/runs/shared/dynamic-fanout.js +273 -0
  437. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  438. package/src/runs/shared/effective-system-prompt.js +23 -0
  439. package/src/runs/shared/extension-bindings.d.ts +25 -0
  440. package/src/runs/shared/extension-bindings.js +96 -0
  441. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  442. package/src/runs/shared/external-cli-contract.js +145 -0
  443. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  444. package/src/runs/shared/external-cli-preflight.js +159 -0
  445. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  446. package/src/runs/shared/external-cli-runner.js +425 -0
  447. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  448. package/src/runs/shared/external-job-bridge.js +486 -0
  449. package/src/runs/shared/external-job-runner.d.ts +44 -0
  450. package/src/runs/shared/external-job-runner.js +352 -0
  451. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  452. package/src/runs/shared/fast-mode-extension.js +8 -0
  453. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  454. package/src/runs/shared/fork-placed-env.js +13 -0
  455. package/src/runs/shared/git-environment.d.ts +2 -0
  456. package/src/runs/shared/git-environment.js +27 -0
  457. package/src/runs/shared/herdr-connection.d.ts +79 -0
  458. package/src/runs/shared/herdr-connection.js +269 -0
  459. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  460. package/src/runs/shared/herdr-external-adapters.js +404 -0
  461. package/src/runs/shared/herdr-machine.d.ts +59 -0
  462. package/src/runs/shared/herdr-machine.js +294 -0
  463. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  464. package/src/runs/shared/herdr-pane-host.js +155 -0
  465. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  466. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  467. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  468. package/src/runs/shared/herdr-placed-run.js +380 -0
  469. package/src/runs/shared/host-step-status.d.ts +33 -0
  470. package/src/runs/shared/host-step-status.js +244 -0
  471. package/src/runs/shared/lane-metadata.d.ts +23 -0
  472. package/src/runs/shared/lane-metadata.js +126 -0
  473. package/src/runs/shared/launch-cwd.d.ts +1 -0
  474. package/src/runs/shared/launch-cwd.js +16 -0
  475. package/src/runs/shared/local-machine-access.d.ts +5 -0
  476. package/src/runs/shared/local-machine-access.js +28 -0
  477. package/src/runs/shared/long-running-guard.d.ts +34 -0
  478. package/src/runs/shared/long-running-guard.js +256 -0
  479. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  480. package/src/runs/shared/mcp-config-sources.js +418 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  482. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  484. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  485. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  486. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  487. package/src/runs/shared/model-resolution.d.ts +109 -0
  488. package/src/runs/shared/model-resolution.js +411 -0
  489. package/src/runs/shared/model-scope.d.ts +68 -0
  490. package/src/runs/shared/model-scope.js +171 -0
  491. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  492. package/src/runs/shared/mutation-evidence.js +198 -0
  493. package/src/runs/shared/nested-events.d.ts +135 -0
  494. package/src/runs/shared/nested-events.js +1090 -0
  495. package/src/runs/shared/nested-path.d.ts +8 -0
  496. package/src/runs/shared/nested-path.js +34 -0
  497. package/src/runs/shared/nested-render.d.ts +20 -0
  498. package/src/runs/shared/nested-render.js +115 -0
  499. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  500. package/src/runs/shared/orca-progress-tabs.js +503 -0
  501. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  502. package/src/runs/shared/parallel-handoff.js +783 -0
  503. package/src/runs/shared/parallel-utils.d.ts +177 -0
  504. package/src/runs/shared/parallel-utils.js +125 -0
  505. package/src/runs/shared/partial-output.d.ts +24 -0
  506. package/src/runs/shared/partial-output.js +35 -0
  507. package/src/runs/shared/permissions.d.ts +12 -0
  508. package/src/runs/shared/permissions.js +92 -0
  509. package/src/runs/shared/pi-spawn.d.ts +31 -0
  510. package/src/runs/shared/pi-spawn.js +211 -0
  511. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  512. package/src/runs/shared/placed-run-owner.js +93 -0
  513. package/src/runs/shared/placement-host.d.ts +99 -0
  514. package/src/runs/shared/placement-host.js +157 -0
  515. package/src/runs/shared/process-signal.d.ts +15 -0
  516. package/src/runs/shared/process-signal.js +21 -0
  517. package/src/runs/shared/profile-extensions.d.ts +21 -0
  518. package/src/runs/shared/profile-extensions.js +122 -0
  519. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  520. package/src/runs/shared/profile-launch-env.js +90 -0
  521. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  522. package/src/runs/shared/readonly-drain-observation.js +50 -0
  523. package/src/runs/shared/rex-machine.d.ts +25 -0
  524. package/src/runs/shared/rex-machine.js +83 -0
  525. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  526. package/src/runs/shared/rex-pane-host.js +327 -0
  527. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  528. package/src/runs/shared/run-fanout-budget.js +258 -0
  529. package/src/runs/shared/run-ownership.d.ts +3 -0
  530. package/src/runs/shared/run-ownership.js +8 -0
  531. package/src/runs/shared/runner-launcher.d.ts +11 -0
  532. package/src/runs/shared/runner-launcher.js +24 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  534. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  535. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  536. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  538. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  539. package/src/runs/shared/session-lease.d.ts +69 -0
  540. package/src/runs/shared/session-lease.js +250 -0
  541. package/src/runs/shared/single-output.d.ts +90 -0
  542. package/src/runs/shared/single-output.js +349 -0
  543. package/src/runs/shared/spawn-budget.d.ts +20 -0
  544. package/src/runs/shared/spawn-budget.js +93 -0
  545. package/src/runs/shared/structured-output.d.ts +66 -0
  546. package/src/runs/shared/structured-output.js +483 -0
  547. package/src/runs/shared/subagent-control.d.ts +50 -0
  548. package/src/runs/shared/subagent-control.js +247 -0
  549. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  550. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  551. package/src/runs/shared/tool-availability.d.ts +16 -0
  552. package/src/runs/shared/tool-availability.js +29 -0
  553. package/src/runs/shared/tool-budget.d.ts +21 -0
  554. package/src/runs/shared/tool-budget.js +78 -0
  555. package/src/runs/shared/tool-timeout.d.ts +31 -0
  556. package/src/runs/shared/tool-timeout.js +73 -0
  557. package/src/runs/shared/usage-budget.d.ts +7 -0
  558. package/src/runs/shared/usage-budget.js +74 -0
  559. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  560. package/src/runs/shared/usage-reconciliation.js +71 -0
  561. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  562. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  563. package/src/runs/shared/workflow-graph.d.ts +31 -0
  564. package/src/runs/shared/workflow-graph.js +221 -0
  565. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  566. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  567. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  568. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  569. package/src/runs/shared/worktree-lock.d.ts +5 -0
  570. package/src/runs/shared/worktree-lock.js +40 -0
  571. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  572. package/src/runs/shared/worktree-setup-command.js +200 -0
  573. package/src/runs/shared/worktree.d.ts +181 -0
  574. package/src/runs/shared/worktree.js +1346 -0
  575. package/src/shared/accessible-dir.d.ts +11 -0
  576. package/src/shared/accessible-dir.js +39 -0
  577. package/src/shared/agent-stream-options.d.ts +5 -0
  578. package/src/shared/agent-stream-options.js +3 -0
  579. package/src/shared/artifacts.d.ts +22 -0
  580. package/src/shared/artifacts.js +272 -0
  581. package/src/shared/atomic-json.d.ts +19 -0
  582. package/src/shared/atomic-json.js +61 -0
  583. package/src/shared/capacity-resilient-json.d.ts +26 -0
  584. package/src/shared/capacity-resilient-json.js +86 -0
  585. package/src/shared/child-cache-retention.d.ts +29 -0
  586. package/src/shared/child-cache-retention.js +40 -0
  587. package/src/shared/child-session-name.d.ts +8 -0
  588. package/src/shared/child-session-name.js +40 -0
  589. package/src/shared/child-transcript.d.ts +37 -0
  590. package/src/shared/child-transcript.js +225 -0
  591. package/src/shared/completion-owner.d.ts +7 -0
  592. package/src/shared/completion-owner.js +13 -0
  593. package/src/shared/disabled-features.d.ts +93 -0
  594. package/src/shared/disabled-features.js +120 -0
  595. package/src/shared/display-text.d.ts +5 -0
  596. package/src/shared/display-text.js +154 -0
  597. package/src/shared/edit-distance.d.ts +4 -0
  598. package/src/shared/edit-distance.js +32 -0
  599. package/src/shared/extension-context.d.ts +21 -0
  600. package/src/shared/extension-context.js +39 -0
  601. package/src/shared/file-coalescer.d.ts +11 -0
  602. package/src/shared/file-coalescer.js +34 -0
  603. package/src/shared/file-lease.d.ts +10 -0
  604. package/src/shared/file-lease.js +106 -0
  605. package/src/shared/file-system-retry.d.ts +31 -0
  606. package/src/shared/file-system-retry.js +84 -0
  607. package/src/shared/fork-context.d.ts +64 -0
  608. package/src/shared/fork-context.js +185 -0
  609. package/src/shared/fork-session-cwd.d.ts +2 -0
  610. package/src/shared/fork-session-cwd.js +23 -0
  611. package/src/shared/formatters.d.ts +35 -0
  612. package/src/shared/formatters.js +137 -0
  613. package/src/shared/jsonl-writer.d.ts +20 -0
  614. package/src/shared/jsonl-writer.js +67 -0
  615. package/src/shared/launch-contract.d.ts +65 -0
  616. package/src/shared/launch-contract.js +145 -0
  617. package/src/shared/model-info.d.ts +55 -0
  618. package/src/shared/model-info.js +103 -0
  619. package/src/shared/model-response-aliases.d.ts +1 -0
  620. package/src/shared/model-response-aliases.js +15 -0
  621. package/src/shared/node-executable.d.ts +1 -0
  622. package/src/shared/node-executable.js +20 -0
  623. package/src/shared/opencode-session-headers.d.ts +12 -0
  624. package/src/shared/opencode-session-headers.js +26 -0
  625. package/src/shared/package-version.d.ts +2 -0
  626. package/src/shared/package-version.js +14 -0
  627. package/src/shared/parent-wake.d.ts +26 -0
  628. package/src/shared/parent-wake.js +68 -0
  629. package/src/shared/permission-profile.d.ts +26 -0
  630. package/src/shared/permission-profile.js +49 -0
  631. package/src/shared/prompt-resources.d.ts +5 -0
  632. package/src/shared/prompt-resources.js +10 -0
  633. package/src/shared/provider-diagnostics.d.ts +9 -0
  634. package/src/shared/provider-diagnostics.js +75 -0
  635. package/src/shared/pruned-fork.d.ts +34 -0
  636. package/src/shared/pruned-fork.js +434 -0
  637. package/src/shared/required-child-extensions.d.ts +34 -0
  638. package/src/shared/required-child-extensions.js +105 -0
  639. package/src/shared/runtime-module-path.d.ts +10 -0
  640. package/src/shared/runtime-module-path.js +16 -0
  641. package/src/shared/sandbox-profile.d.ts +12 -0
  642. package/src/shared/sandbox-profile.js +35 -0
  643. package/src/shared/session-file-trust.d.ts +1 -0
  644. package/src/shared/session-file-trust.js +20 -0
  645. package/src/shared/session-identity.d.ts +8 -0
  646. package/src/shared/session-identity.js +32 -0
  647. package/src/shared/session-succession.d.ts +4 -0
  648. package/src/shared/session-succession.js +24 -0
  649. package/src/shared/session-tokens.d.ts +2 -0
  650. package/src/shared/session-tokens.js +58 -0
  651. package/src/shared/settings-file-lease.d.ts +4 -0
  652. package/src/shared/settings-file-lease.js +38 -0
  653. package/src/shared/settings.d.ts +146 -0
  654. package/src/shared/settings.js +247 -0
  655. package/src/shared/shortcuts.d.ts +1 -0
  656. package/src/shared/shortcuts.js +17 -0
  657. package/src/shared/status-format.d.ts +9 -0
  658. package/src/shared/status-format.js +60 -0
  659. package/src/shared/thinking-ceiling.d.ts +13 -0
  660. package/src/shared/thinking-ceiling.js +37 -0
  661. package/src/shared/types.d.ts +2840 -0
  662. package/src/shared/types.js +276 -0
  663. package/src/shared/utf8.d.ts +5 -0
  664. package/src/shared/utf8.js +12 -0
  665. package/src/shared/utils.d.ts +83 -0
  666. package/src/shared/utils.js +612 -0
  667. package/src/shared/watch-strategy.d.ts +2 -0
  668. package/src/shared/watch-strategy.js +5 -0
  669. package/src/shared/workflow-child-permit.d.ts +58 -0
  670. package/src/shared/workflow-child-permit.js +159 -0
  671. package/src/slash/delegation-adapters.d.ts +154 -0
  672. package/src/slash/delegation-adapters.js +316 -0
  673. package/src/slash/delegation-json.d.ts +10 -0
  674. package/src/slash/delegation-json.js +117 -0
  675. package/src/slash/delegation-request.d.ts +12 -0
  676. package/src/slash/delegation-request.js +174 -0
  677. package/src/slash/prompt-template-bridge.d.ts +29 -0
  678. package/src/slash/prompt-template-bridge.js +399 -0
  679. package/src/slash/prompt-workflows.d.ts +21 -0
  680. package/src/slash/prompt-workflows.js +274 -0
  681. package/src/slash/selector.d.ts +47 -0
  682. package/src/slash/selector.js +117 -0
  683. package/src/slash/slash-bridge.d.ts +30 -0
  684. package/src/slash/slash-bridge.js +132 -0
  685. package/src/slash/slash-commands.d.ts +10 -0
  686. package/src/slash/slash-commands.js +1059 -0
  687. package/src/slash/slash-live-state.d.ts +21 -0
  688. package/src/slash/slash-live-state.js +263 -0
  689. package/src/slash/subagent-cost.d.ts +29 -0
  690. package/src/slash/subagent-cost.js +310 -0
  691. package/src/slash/subagents-admin.d.ts +3 -0
  692. package/src/slash/subagents-admin.js +481 -0
  693. package/src/tui/fleet-layout.d.ts +20 -0
  694. package/src/tui/fleet-layout.js +17 -0
  695. package/src/tui/fleet-native-transcript.d.ts +53 -0
  696. package/src/tui/fleet-native-transcript.js +339 -0
  697. package/src/tui/fleet-status.d.ts +92 -0
  698. package/src/tui/fleet-status.js +1132 -0
  699. package/src/tui/fleet-transcript.d.ts +64 -0
  700. package/src/tui/fleet-transcript.js +544 -0
  701. package/src/tui/fleet-viewport.d.ts +12 -0
  702. package/src/tui/fleet-viewport.js +35 -0
  703. package/src/tui/fleet.d.ts +196 -0
  704. package/src/tui/fleet.js +1588 -0
  705. package/src/tui/mouse-events.d.ts +21 -0
  706. package/src/tui/mouse-events.js +26 -0
  707. package/src/tui/render-helpers.d.ts +23 -0
  708. package/src/tui/render-helpers.js +100 -0
  709. package/src/tui/render.d.ts +66 -0
  710. package/src/tui/render.js +3707 -0
  711. package/src/tui/running-tone.d.ts +10 -0
  712. package/src/tui/running-tone.js +22 -0
  713. package/src/tui/subagent-messages.d.ts +22 -0
  714. package/src/tui/subagent-messages.js +270 -0
  715. package/src/ui-silent-marker.d.ts +20 -0
  716. package/src/ui-silent-marker.js +25 -0
  717. package/src/watchdog/change-signature.d.ts +7 -0
  718. package/src/watchdog/change-signature.js +243 -0
  719. package/src/watchdog/child-status.d.ts +53 -0
  720. package/src/watchdog/child-status.js +187 -0
  721. package/src/watchdog/diff-tool.d.ts +25 -0
  722. package/src/watchdog/diff-tool.js +104 -0
  723. package/src/watchdog/emission-guard.d.ts +36 -0
  724. package/src/watchdog/emission-guard.js +97 -0
  725. package/src/watchdog/guidance.d.ts +3 -0
  726. package/src/watchdog/guidance.js +19 -0
  727. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  728. package/src/watchdog/lsp-diagnostics.js +489 -0
  729. package/src/watchdog/model-selection.d.ts +24 -0
  730. package/src/watchdog/model-selection.js +167 -0
  731. package/src/watchdog/permission-arbiter.d.ts +20 -0
  732. package/src/watchdog/permission-arbiter.js +135 -0
  733. package/src/watchdog/register-child.d.ts +13 -0
  734. package/src/watchdog/register-child.js +128 -0
  735. package/src/watchdog/register-main.d.ts +11 -0
  736. package/src/watchdog/register-main.js +400 -0
  737. package/src/watchdog/render.d.ts +3 -0
  738. package/src/watchdog/render.js +33 -0
  739. package/src/watchdog/review.d.ts +36 -0
  740. package/src/watchdog/review.js +319 -0
  741. package/src/watchdog/rules.d.ts +21 -0
  742. package/src/watchdog/rules.js +58 -0
  743. package/src/watchdog/runtime.d.ts +195 -0
  744. package/src/watchdog/runtime.js +864 -0
  745. package/src/watchdog/scope.d.ts +14 -0
  746. package/src/watchdog/scope.js +44 -0
  747. package/src/watchdog/settings.d.ts +29 -0
  748. package/src/watchdog/settings.js +480 -0
  749. package/src/watchdog/tool-actions.d.ts +17 -0
  750. package/src/watchdog/tool-actions.js +150 -0
  751. package/src/watchdog/turn-delta.d.ts +15 -0
  752. package/src/watchdog/turn-delta.js +188 -0
  753. package/src/watchdog/types.d.ts +141 -0
  754. package/src/watchdog/types.js +27 -0
  755. package/src/watchdog/warning-format.d.ts +7 -0
  756. package/src/watchdog/warning-format.js +59 -0
  757. package/src/workflows/chat-progress.d.ts +37 -0
  758. package/src/workflows/chat-progress.js +129 -0
  759. package/src/workflows/host-command.d.ts +30 -0
  760. package/src/workflows/host-command.js +227 -0
  761. package/src/workflows/scripted-workflow.d.ts +204 -0
  762. package/src/workflows/scripted-workflow.js +1673 -0
  763. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  764. package/src/workflows/structured-workflow-scripts.js +179 -0
  765. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  766. package/src/workflows/workflow-auto-resume.js +102 -0
  767. package/src/workflows/workflow-checklist.d.ts +127 -0
  768. package/src/workflows/workflow-checklist.js +314 -0
  769. package/src/workflows/workflow-child-summary.d.ts +24 -0
  770. package/src/workflows/workflow-child-summary.js +195 -0
  771. package/src/workflows/workflow-launch-record.d.ts +27 -0
  772. package/src/workflows/workflow-launch-record.js +48 -0
  773. package/src/workflows/workflow-preflight.d.ts +58 -0
  774. package/src/workflows/workflow-preflight.js +288 -0
  775. package/src/workflows/workflow-receipt.d.ts +34 -0
  776. package/src/workflows/workflow-receipt.js +454 -0
  777. package/src/workflows/workflow-resources.d.ts +55 -0
  778. package/src/workflows/workflow-resources.js +271 -0
  779. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  780. package/src/workflows/workflow-resume-claim.js +210 -0
  781. package/src/workflows/workflow-resume.d.ts +56 -0
  782. package/src/workflows/workflow-resume.js +106 -0
  783. package/src/workflows/workflow-reuse.d.ts +61 -0
  784. package/src/workflows/workflow-reuse.js +186 -0
  785. package/src/workflows/workflow-revival.d.ts +33 -0
  786. package/src/workflows/workflow-revival.js +111 -0
  787. package/src/workflows/workflow-settlement.d.ts +84 -0
  788. package/src/workflows/workflow-settlement.js +203 -0
  789. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  790. package/src/workflows/workflow-stop-cause.js +8 -0
  791. package/workflow-script-worker.cjs +1342 -0
  792. package/index.ts +0 -18
  793. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  794. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  795. package/skills/pi-subagents/references/execution-controls.md +0 -561
  796. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  797. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  798. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  799. package/src/agents/advertised-agent-prompt.ts +0 -82
  800. package/src/agents/agent-eject.ts +0 -339
  801. package/src/agents/agent-management.ts +0 -1442
  802. package/src/agents/agent-memory.ts +0 -341
  803. package/src/agents/agent-refinements.ts +0 -624
  804. package/src/agents/agent-scope.ts +0 -10
  805. package/src/agents/agent-selection.ts +0 -25
  806. package/src/agents/agent-serializer.ts +0 -195
  807. package/src/agents/agents.ts +0 -3169
  808. package/src/agents/builtin-names.ts +0 -16
  809. package/src/agents/chain-serializer.ts +0 -285
  810. package/src/agents/frontmatter.ts +0 -153
  811. package/src/agents/global-npm-root.ts +0 -58
  812. package/src/agents/identity.ts +0 -30
  813. package/src/agents/proactive-skills.ts +0 -197
  814. package/src/agents/runtime-agent-events.ts +0 -70
  815. package/src/agents/runtime-agent-registry.ts +0 -457
  816. package/src/agents/runtime-discovery.ts +0 -39
  817. package/src/agents/skills.ts +0 -787
  818. package/src/api/agent-management.ts +0 -9
  819. package/src/api/agents.ts +0 -19
  820. package/src/api/background-work.ts +0 -206
  821. package/src/api/capability-ceiling.ts +0 -16
  822. package/src/api/child-tool-plan.ts +0 -5
  823. package/src/api/control-channel.ts +0 -4
  824. package/src/api/delegation.ts +0 -131
  825. package/src/api/external-job-provider.ts +0 -195
  826. package/src/api/external-runs.ts +0 -282
  827. package/src/api/inspectors.ts +0 -27
  828. package/src/api/intercom-bridge.ts +0 -3
  829. package/src/api/preflight.ts +0 -641
  830. package/src/api/project-panes.ts +0 -32
  831. package/src/api/required-child-extensions.ts +0 -6
  832. package/src/api/shared-types.ts +0 -29
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1185
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/intercom-bridge.ts +0 -235
  873. package/src/intercom/native-supervisor-channel.ts +0 -1000
  874. package/src/intercom/result-intercom.ts +0 -433
  875. package/src/intercom/supervisor-ui.ts +0 -72
  876. package/src/missions/actions.ts +0 -433
  877. package/src/missions/goal-driver.ts +0 -177
  878. package/src/missions/lifecycle.ts +0 -367
  879. package/src/missions/store.ts +0 -613
  880. package/src/missions/types.ts +0 -190
  881. package/src/missions/workflow-state.ts +0 -281
  882. package/src/policy/authority.ts +0 -50
  883. package/src/profiles/profiles.ts +0 -674
  884. package/src/runs/background/active-async-capacity.ts +0 -548
  885. package/src/runs/background/active-run-index.ts +0 -155
  886. package/src/runs/background/async-execution.ts +0 -2479
  887. package/src/runs/background/async-job-tracker.ts +0 -869
  888. package/src/runs/background/async-resume.ts +0 -686
  889. package/src/runs/background/async-retention.ts +0 -953
  890. package/src/runs/background/async-status-snapshot.ts +0 -46
  891. package/src/runs/background/async-status.ts +0 -787
  892. package/src/runs/background/auto-drain.ts +0 -92
  893. package/src/runs/background/await-async-run.ts +0 -83
  894. package/src/runs/background/binary-bootstrap.ts +0 -67
  895. package/src/runs/background/calendar-schedule.ts +0 -90
  896. package/src/runs/background/chain-append.ts +0 -321
  897. package/src/runs/background/chain-root-attachment.ts +0 -263
  898. package/src/runs/background/completion-batcher.ts +0 -168
  899. package/src/runs/background/completion-dedupe.ts +0 -58
  900. package/src/runs/background/completion-replay.ts +0 -287
  901. package/src/runs/background/control-channel.ts +0 -659
  902. package/src/runs/background/fleet-view.ts +0 -692
  903. package/src/runs/background/index-segment.ts +0 -59
  904. package/src/runs/background/inspect-rpc.ts +0 -443
  905. package/src/runs/background/notify.ts +0 -1083
  906. package/src/runs/background/owned-process-tree.ts +0 -131
  907. package/src/runs/background/parallel-groups.ts +0 -45
  908. package/src/runs/background/pid-namespace.ts +0 -18
  909. package/src/runs/background/process-terminal-candidate.ts +0 -98
  910. package/src/runs/background/process-terminal.ts +0 -231
  911. package/src/runs/background/result-delivery-ownership.ts +0 -45
  912. package/src/runs/background/result-files.ts +0 -634
  913. package/src/runs/background/result-watcher.ts +0 -842
  914. package/src/runs/background/resume-guidance.ts +0 -56
  915. package/src/runs/background/retained-children.ts +0 -136
  916. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  917. package/src/runs/background/run-child-session.ts +0 -725
  918. package/src/runs/background/run-id-query.ts +0 -7
  919. package/src/runs/background/run-id-resolver.ts +0 -183
  920. package/src/runs/background/run-status.ts +0 -803
  921. package/src/runs/background/runner-aliases.ts +0 -183
  922. package/src/runs/background/runner-child-launch.ts +0 -96
  923. package/src/runs/background/runner-child-sessions.ts +0 -32
  924. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  925. package/src/runs/background/runner-startup-failure.ts +0 -56
  926. package/src/runs/background/scheduled-runs.ts +0 -1222
  927. package/src/runs/background/stale-run-reconciler.ts +0 -463
  928. package/src/runs/background/steering.ts +0 -260
  929. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  930. package/src/runs/background/subagent-runner.ts +0 -5251
  931. package/src/runs/background/subagent-wait.ts +0 -895
  932. package/src/runs/background/terminal-run-index.ts +0 -183
  933. package/src/runs/background/top-level-async.ts +0 -14
  934. package/src/runs/background/wait-completions.ts +0 -262
  935. package/src/runs/background/wait-config.ts +0 -50
  936. package/src/runs/background/wait-subscriptions.ts +0 -354
  937. package/src/runs/background/wait-tool.ts +0 -57
  938. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  939. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  940. package/src/runs/foreground/async-steering-action.ts +0 -276
  941. package/src/runs/foreground/async-stop-action.ts +0 -216
  942. package/src/runs/foreground/command-action.ts +0 -41
  943. package/src/runs/foreground/execution.ts +0 -2315
  944. package/src/runs/foreground/foreground-control.ts +0 -157
  945. package/src/runs/foreground/foreground-history.ts +0 -164
  946. package/src/runs/foreground/prompt-audit.ts +0 -172
  947. package/src/runs/foreground/subagent-executor.ts +0 -8227
  948. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  949. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  950. package/src/runs/shared/abort-recovery.ts +0 -119
  951. package/src/runs/shared/acceptance.ts +0 -1664
  952. package/src/runs/shared/agent-contract.ts +0 -38
  953. package/src/runs/shared/async-status-projection.ts +0 -664
  954. package/src/runs/shared/background-process-options.ts +0 -9
  955. package/src/runs/shared/capability-ceiling.ts +0 -214
  956. package/src/runs/shared/chain-outputs.ts +0 -116
  957. package/src/runs/shared/child-commands.ts +0 -229
  958. package/src/runs/shared/child-hooks.ts +0 -175
  959. package/src/runs/shared/child-identity.ts +0 -62
  960. package/src/runs/shared/child-launch-plan.ts +0 -163
  961. package/src/runs/shared/child-launch.ts +0 -389
  962. package/src/runs/shared/child-lifecycle.ts +0 -28
  963. package/src/runs/shared/child-runtime-config.ts +0 -136
  964. package/src/runs/shared/child-session.ts +0 -699
  965. package/src/runs/shared/child-tool-plan.ts +0 -599
  966. package/src/runs/shared/claude-code-adapter.ts +0 -288
  967. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  968. package/src/runs/shared/context-mode.ts +0 -44
  969. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  970. package/src/runs/shared/dynamic-fanout.ts +0 -297
  971. package/src/runs/shared/effective-system-prompt.ts +0 -33
  972. package/src/runs/shared/extension-bindings.ts +0 -103
  973. package/src/runs/shared/external-cli-contract.ts +0 -177
  974. package/src/runs/shared/external-cli-preflight.ts +0 -190
  975. package/src/runs/shared/external-cli-runner.ts +0 -437
  976. package/src/runs/shared/external-job-bridge.ts +0 -514
  977. package/src/runs/shared/external-job-runner.ts +0 -389
  978. package/src/runs/shared/fast-mode-extension.ts +0 -10
  979. package/src/runs/shared/fork-command-result.ts +0 -10
  980. package/src/runs/shared/git-environment.ts +0 -29
  981. package/src/runs/shared/herdr-connection.ts +0 -134
  982. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  983. package/src/runs/shared/herdr-machine.ts +0 -279
  984. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  985. package/src/runs/shared/herdr-placed-run.ts +0 -264
  986. package/src/runs/shared/host-step-status.ts +0 -231
  987. package/src/runs/shared/lane-metadata.ts +0 -126
  988. package/src/runs/shared/launch-cwd.ts +0 -16
  989. package/src/runs/shared/long-running-guard.ts +0 -221
  990. package/src/runs/shared/mcp-config-sources.ts +0 -426
  991. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  992. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  993. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  994. package/src/runs/shared/model-resolution.ts +0 -503
  995. package/src/runs/shared/model-scope.ts +0 -224
  996. package/src/runs/shared/mutation-evidence.ts +0 -199
  997. package/src/runs/shared/nested-events.ts +0 -1125
  998. package/src/runs/shared/nested-path.ts +0 -38
  999. package/src/runs/shared/nested-render.ts +0 -127
  1000. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1001. package/src/runs/shared/parallel-handoff.ts +0 -789
  1002. package/src/runs/shared/parallel-utils.ts +0 -292
  1003. package/src/runs/shared/partial-output.ts +0 -48
  1004. package/src/runs/shared/permissions.ts +0 -86
  1005. package/src/runs/shared/pi-spawn.ts +0 -205
  1006. package/src/runs/shared/process-signal.ts +0 -35
  1007. package/src/runs/shared/profile-extensions.ts +0 -134
  1008. package/src/runs/shared/profile-launch-env.ts +0 -121
  1009. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1010. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1011. package/src/runs/shared/run-history.ts +0 -288
  1012. package/src/runs/shared/runner-launcher.ts +0 -25
  1013. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1014. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1015. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1016. package/src/runs/shared/session-lease.ts +0 -293
  1017. package/src/runs/shared/single-output.ts +0 -366
  1018. package/src/runs/shared/spawn-budget.ts +0 -128
  1019. package/src/runs/shared/structured-output.ts +0 -463
  1020. package/src/runs/shared/subagent-control.ts +0 -295
  1021. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1022. package/src/runs/shared/tool-availability.ts +0 -37
  1023. package/src/runs/shared/tool-budget.ts +0 -87
  1024. package/src/runs/shared/tool-timeout.ts +0 -93
  1025. package/src/runs/shared/usage-budget.ts +0 -65
  1026. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1027. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1028. package/src/runs/shared/workflow-graph.ts +0 -225
  1029. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1030. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1031. package/src/runs/shared/worktree-lock.ts +0 -29
  1032. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1033. package/src/runs/shared/worktree.ts +0 -1554
  1034. package/src/shared/accessible-dir.ts +0 -47
  1035. package/src/shared/agent-stream-options.ts +0 -5
  1036. package/src/shared/artifacts.ts +0 -281
  1037. package/src/shared/atomic-json.ts +0 -85
  1038. package/src/shared/capacity-resilient-json.ts +0 -102
  1039. package/src/shared/child-cache-retention.ts +0 -43
  1040. package/src/shared/child-session-name.ts +0 -48
  1041. package/src/shared/child-transcript.ts +0 -264
  1042. package/src/shared/completion-owner.ts +0 -14
  1043. package/src/shared/disabled-features.ts +0 -123
  1044. package/src/shared/display-text.ts +0 -150
  1045. package/src/shared/edit-distance.ts +0 -33
  1046. package/src/shared/extension-context.ts +0 -37
  1047. package/src/shared/file-coalescer.ts +0 -49
  1048. package/src/shared/file-lease.ts +0 -74
  1049. package/src/shared/file-system-retry.ts +0 -95
  1050. package/src/shared/fork-context.ts +0 -243
  1051. package/src/shared/fork-session-cwd.ts +0 -27
  1052. package/src/shared/formatters.ts +0 -142
  1053. package/src/shared/jsonl-writer.ts +0 -92
  1054. package/src/shared/launch-contract.ts +0 -206
  1055. package/src/shared/model-info.ts +0 -132
  1056. package/src/shared/model-response-aliases.ts +0 -13
  1057. package/src/shared/node-executable.ts +0 -21
  1058. package/src/shared/opencode-session-headers.ts +0 -30
  1059. package/src/shared/package-version.ts +0 -17
  1060. package/src/shared/parent-wake.ts +0 -79
  1061. package/src/shared/permission-profile.ts +0 -56
  1062. package/src/shared/prompt-resources.ts +0 -11
  1063. package/src/shared/pruned-fork.ts +0 -469
  1064. package/src/shared/required-child-extensions.ts +0 -115
  1065. package/src/shared/runtime-module-path.ts +0 -19
  1066. package/src/shared/sandbox-profile.ts +0 -37
  1067. package/src/shared/session-file-trust.ts +0 -19
  1068. package/src/shared/session-identity.ts +0 -10
  1069. package/src/shared/session-tokens.ts +0 -55
  1070. package/src/shared/settings-file-lease.ts +0 -36
  1071. package/src/shared/settings.ts +0 -412
  1072. package/src/shared/shortcuts.ts +0 -13
  1073. package/src/shared/status-format.ts +0 -55
  1074. package/src/shared/thinking-ceiling.ts +0 -46
  1075. package/src/shared/types.ts +0 -3105
  1076. package/src/shared/utf8.ts +0 -11
  1077. package/src/shared/utils.ts +0 -610
  1078. package/src/shared/watch-strategy.ts +0 -12
  1079. package/src/shared/workflow-child-permit.ts +0 -212
  1080. package/src/slash/delegation-adapters.ts +0 -452
  1081. package/src/slash/delegation-json.ts +0 -108
  1082. package/src/slash/delegation-request.ts +0 -176
  1083. package/src/slash/prompt-template-bridge.ts +0 -434
  1084. package/src/slash/prompt-workflows.ts +0 -298
  1085. package/src/slash/selector.ts +0 -147
  1086. package/src/slash/slash-bridge.ts +0 -192
  1087. package/src/slash/slash-commands.ts +0 -1096
  1088. package/src/slash/slash-live-state.ts +0 -310
  1089. package/src/slash/subagent-cost.ts +0 -317
  1090. package/src/slash/subagents-admin.ts +0 -489
  1091. package/src/tui/fleet-native-transcript.ts +0 -424
  1092. package/src/tui/fleet-status.ts +0 -1139
  1093. package/src/tui/fleet-transcript.ts +0 -591
  1094. package/src/tui/fleet.ts +0 -1618
  1095. package/src/tui/mouse-events.ts +0 -42
  1096. package/src/tui/render-helpers.ts +0 -111
  1097. package/src/tui/render.ts +0 -3824
  1098. package/src/tui/running-tone.ts +0 -28
  1099. package/src/tui/subagent-messages.ts +0 -305
  1100. package/src/ui-silent-marker.ts +0 -32
  1101. package/src/watchdog/change-signature.ts +0 -260
  1102. package/src/watchdog/child-status.ts +0 -225
  1103. package/src/watchdog/diff-tool.ts +0 -112
  1104. package/src/watchdog/emission-guard.ts +0 -125
  1105. package/src/watchdog/guidance.ts +0 -20
  1106. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1107. package/src/watchdog/model-selection.ts +0 -187
  1108. package/src/watchdog/permission-arbiter.ts +0 -154
  1109. package/src/watchdog/register-child.ts +0 -136
  1110. package/src/watchdog/register-main.ts +0 -425
  1111. package/src/watchdog/render.ts +0 -31
  1112. package/src/watchdog/review.ts +0 -362
  1113. package/src/watchdog/rules.ts +0 -70
  1114. package/src/watchdog/runtime.ts +0 -927
  1115. package/src/watchdog/scope.ts +0 -51
  1116. package/src/watchdog/settings.ts +0 -520
  1117. package/src/watchdog/tool-actions.ts +0 -156
  1118. package/src/watchdog/turn-delta.ts +0 -190
  1119. package/src/watchdog/types.ts +0 -186
  1120. package/src/watchdog/warning-format.ts +0 -72
  1121. package/src/workflows/chat-progress.ts +0 -152
  1122. package/src/workflows/host-command.ts +0 -235
  1123. package/src/workflows/scripted-workflow.ts +0 -2733
  1124. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1125. package/src/workflows/workflow-checklist.ts +0 -442
  1126. package/src/workflows/workflow-child-summary.ts +0 -172
  1127. package/src/workflows/workflow-preflight.ts +0 -297
  1128. package/src/workflows/workflow-receipt.ts +0 -390
  1129. package/src/workflows/workflow-resources.ts +0 -275
  1130. package/src/workflows/workflow-reuse.ts +0 -120
  1131. package/src/workflows/workflow-revival.ts +0 -123
  1132. package/src/workflows/workflow-settlement.ts +0 -252
@@ -1,598 +0,0 @@
1
- import { createHash } from "node:crypto";
2
- import * as fs from "node:fs";
3
- import * as path from "node:path";
4
- import type { BeforeAgentStartEvent, BeforeProviderRequestEvent, ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
5
- import { registerNativeSupervisorClient } from "../../intercom/native-supervisor-channel.ts";
6
- import { permissionDecision } from "./permissions.ts";
7
- import type { SteerRequest } from "../background/control-channel.ts";
8
- import { RUNTIME_EXTENSION_ACK_EVENT, isRuntimeAcknowledgedExtensionId } from "./runtime-acknowledged-extensions.ts";
9
- import { createStructuredOutputToolParameters, MISSING_STRUCTURED_ACCEPTANCE_REPORT_ERROR, validateStructuredOutputValue } from "./structured-output.ts";
10
- import { validateAcceptanceReport } from "./acceptance.ts";
11
- import { formatChildToolDiagnostic } from "./tool-availability.ts";
12
- import { shouldBlockToolForBudget, toolBudgetBlockedMessage, toolBudgetSoftNudge } from "./tool-budget.ts";
13
- import type { ResolvedToolBudget, SubagentState } from "../../shared/types.ts";
14
- import { INTERCOM_SESSION_IDENTITY_EVENT } from "../../shared/types.ts";
15
- import { resolveCurrentSessionId } from "../../shared/session-identity.ts";
16
- import { getAgentDir } from "../../shared/utils.ts";
17
- import { registerChildWatchdog } from "../../watchdog/register-child.ts";
18
- import type { ChildWatchdogConfig } from "../../watchdog/child-status.ts";
19
- import { requestWatchdogPermission, type WatchdogPermissionRequest, type WatchdogPermissionResult } from "../../watchdog/permission-arbiter.ts";
20
- import { SUBAGENT_WATCHDOG_WARNING_TYPE } from "../../watchdog/types.ts";
21
- import { captureWatchdogDiffBaseline, createWatchdogDiffTool, WATCHDOG_DIFF_TOOL_NAME } from "../../watchdog/diff-tool.ts";
22
- import { inheritedNestedRouteOf } from "./nested-events.ts";
23
- import { registerWaitTool } from "../background/wait-tool.ts";
24
- import { drainOutstandingWork } from "../background/auto-drain.ts";
25
- import { MODEL_ONLY_TOOL } from "../../shared/extension-context.ts";
26
- import {
27
- childSupervisorMetadata,
28
- evaluateChildToolDiagnostic,
29
- type ChildPermissions,
30
- type ChildRuntimeConfig,
31
- } from "./child-runtime-config.ts";
32
-
33
- const STRUCTURED_OUTPUT_INSTRUCTIONS = [
34
- "This subagent step has a strict structured output contract.",
35
- "Your final action must be to call the `structured_output` tool with JSON matching the provided schema.",
36
- "Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step.",
37
- ].join("\n");
38
-
39
- export const CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS = [
40
- "You are a child subagent, not the parent orchestrator.",
41
- "The parent session owns delegation, orchestration, review fanout, and follow-up worker launches.",
42
- "Ignore prior parent-only orchestration instructions in inherited conversation history.",
43
- "Do not propose or run subagents. Complete only your assigned role-specific task with the tools available to you.",
44
- "If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.",
45
- ].join("\n");
46
-
47
- export const CHILD_FANOUT_BOUNDARY_INSTRUCTIONS = [
48
- "You are a child subagent with explicit fanout responsibility for this assigned task.",
49
- "The parent session owns final orchestration, acceptance, and follow-up implementation launches.",
50
- "You may use the `subagent` tool only for the fanout work explicitly requested in this task.",
51
- "Do not broaden yourself into general parent orchestration. Do not launch follow-up workers unless the task explicitly asks for that.",
52
- "The maxSubagentDepth cap still applies and may block further fanout.",
53
- "If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.",
54
- ].join("\n");
55
-
56
- const PARENT_ONLY_CUSTOM_MESSAGE_TYPES = new Set([
57
- "subagent-orchestration-instructions",
58
- "subagent-slash-result",
59
- "subagent-slash-text-result",
60
- "subagent-notify",
61
- "subagent_control_notice",
62
- "subagent-control",
63
- "subagent-control-notice",
64
- ]);
65
- const SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN = /<name>\s*pi-subagents\s*<\/name>/;
66
- const PROJECT_CONTEXT_XML_HEADER = "\n\n<project_context>\n\n";
67
- const PROJECT_CONTEXT_LEGACY_HEADER = "\n\n# Project Context\n\nProject-specific instructions and guidelines:\n\n";
68
- const SKILLS_HEADER = "\n\nThe following skills provide specialized instructions for specific tasks.";
69
- const DATE_HEADER = "\nCurrent date:";
70
-
71
- function registerRuntimeExtensionAcknowledgements(pi: ExtensionAPI, sink: ((ids: string[]) => void) | undefined): void {
72
- if (!sink) return;
73
- const ids: string[] = [];
74
- let finalized = false;
75
- const acknowledge = (payload: unknown): undefined => {
76
- if (finalized || !payload || typeof payload !== "object") return undefined;
77
- const id = (payload as { id?: unknown }).id;
78
- if (isRuntimeAcknowledgedExtensionId(id)) ids.push(id);
79
- return undefined;
80
- };
81
- const finalize = (): undefined => {
82
- if (finalized) return undefined;
83
- finalized = true;
84
- sink(ids);
85
- return undefined;
86
- };
87
- try {
88
- const events = (pi as { events?: { on?: (event: string, handler: (payload: unknown) => unknown) => unknown } }).events;
89
- events?.on?.(RUNTIME_EXTENSION_ACK_EVENT, acknowledge);
90
- const onRuntimeEvent = pi.on as unknown as (event: string, handler: (event?: unknown, ctx?: unknown) => unknown) => void;
91
- onRuntimeEvent("agent_end", finalize);
92
- onRuntimeEvent("session_shutdown", finalize);
93
- } catch {
94
- // Acknowledgement collection is optional observability and must not affect child execution.
95
- }
96
- }
97
-
98
- function findSectionEnd(prompt: string, startIndex: number, nextHeaders: string[]): number {
99
- let endIndex = prompt.length;
100
- for (const header of nextHeaders) {
101
- const index = prompt.indexOf(header, startIndex);
102
- if (index !== -1 && index < endIndex) {
103
- endIndex = index;
104
- }
105
- }
106
- return endIndex;
107
- }
108
-
109
- export function stripProjectContext(prompt: string): string {
110
- const xmlStartIndex = prompt.indexOf(PROJECT_CONTEXT_XML_HEADER);
111
- if (xmlStartIndex !== -1) {
112
- const closingTag = "</project_context>";
113
- const closingIndex = prompt.indexOf(closingTag, xmlStartIndex + PROJECT_CONTEXT_XML_HEADER.length);
114
- if (closingIndex !== -1) {
115
- return `${prompt.slice(0, xmlStartIndex)}${prompt.slice(closingIndex + closingTag.length)}`;
116
- }
117
- }
118
- const legacyStartIndex = prompt.indexOf(PROJECT_CONTEXT_LEGACY_HEADER);
119
- if (legacyStartIndex === -1) return prompt;
120
- const endIndex = findSectionEnd(prompt, legacyStartIndex + PROJECT_CONTEXT_LEGACY_HEADER.length, [SKILLS_HEADER, DATE_HEADER]);
121
- return `${prompt.slice(0, legacyStartIndex)}${prompt.slice(endIndex)}`;
122
- }
123
-
124
- const GLOBAL_CONTEXT_FILE_NAMES = new Set(["agents.md", "agents.override.md", "claude.md"]);
125
-
126
- function canonicalDirectory(dir: string): string {
127
- try {
128
- return fs.realpathSync(dir);
129
- } catch {
130
- return path.resolve(dir);
131
- }
132
- }
133
-
134
- function expandContextPath(filePath: string): string {
135
- const home = process.env.HOME ?? process.env.USERPROFILE;
136
- return filePath === "~"
137
- ? home ?? filePath
138
- : /^~[\\/]/.test(filePath)
139
- ? path.join(home ?? "~", filePath.slice(2))
140
- : filePath;
141
- }
142
-
143
- function isContextFilePath(filePath: string): boolean {
144
- return GLOBAL_CONTEXT_FILE_NAMES.has(path.basename(expandContextPath(filePath)).toLowerCase());
145
- }
146
-
147
- function isGlobalContextFile(filePath: string): boolean {
148
- const expanded = expandContextPath(filePath);
149
- if (!isContextFilePath(filePath)) return false;
150
- return canonicalDirectory(path.dirname(expanded)) === canonicalDirectory(getAgentDir());
151
- }
152
-
153
- function stripGlobalInstructionsFromXmlContext(context: string): string {
154
- const block = /<project_instructions\s+path=(["'])(.*?)\1\s*>[\s\S]*?<\/project_instructions>\s*/gi;
155
- return context.replace(block, (match, _quote: string, filePath: string) => isGlobalContextFile(filePath) ? "" : match);
156
- }
157
-
158
- function stripGlobalInstructionsFromLegacyContext(context: string): string {
159
- const sections = [...context.matchAll(/^## ([^\r\n]+)(?:\r?\n|$)/gm)]
160
- .filter((match) => isContextFilePath(match[1]!.trim()));
161
- let rewritten = "";
162
- let cursor = 0;
163
- for (let index = 0; index < sections.length; index++) {
164
- const section = sections[index]!;
165
- const start = section.index!;
166
- const end = sections[index + 1]?.index ?? context.length;
167
- rewritten += context.slice(cursor, start);
168
- if (!isGlobalContextFile(section[1]!.trim())) rewritten += context.slice(start, end);
169
- cursor = end;
170
- }
171
- return `${rewritten}${context.slice(cursor)}`;
172
- }
173
-
174
- export function stripGlobalContext(prompt: string): string {
175
- const rewrittenXml = prompt.replace(/<project_context>[\s\S]*?<\/project_context>/gi, (context) => {
176
- const rewritten = stripGlobalInstructionsFromXmlContext(context);
177
- return /<project_instructions\b/i.test(rewritten) ? rewritten : "";
178
- });
179
- const legacyStartIndex = rewrittenXml.indexOf(PROJECT_CONTEXT_LEGACY_HEADER);
180
- if (legacyStartIndex === -1) return rewrittenXml;
181
- const legacyEndIndex = findSectionEnd(rewrittenXml, legacyStartIndex + PROJECT_CONTEXT_LEGACY_HEADER.length, [SKILLS_HEADER, DATE_HEADER]);
182
- const legacyContext = rewrittenXml.slice(legacyStartIndex, legacyEndIndex);
183
- return `${rewrittenXml.slice(0, legacyStartIndex)}${stripGlobalInstructionsFromLegacyContext(legacyContext)}${rewrittenXml.slice(legacyEndIndex)}`;
184
- }
185
-
186
- export function stripInheritedSkills(prompt: string): string {
187
- const startIndex = prompt.indexOf(SKILLS_HEADER);
188
- if (startIndex === -1) return prompt;
189
- const endIndex = findSectionEnd(prompt, startIndex + SKILLS_HEADER.length, [DATE_HEADER]);
190
- return `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;
191
- }
192
-
193
- export function stripSubagentOrchestrationSkill(prompt: string): string {
194
- return prompt
195
- .replace(/\n{0,2}<skill\s+name=["']pi-subagents["'][^>]*>[\s\S]*?<\/skill>\n{0,2}/g, "\n\n")
196
- .replace(/[ \t]*<skill>\s*[\s\S]*?<\/skill>\s*/g, (block) => SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN.test(block) ? "" : block);
197
- }
198
-
199
- function stripChildBoundaryInstructions(prompt: string): string {
200
- let rewritten = prompt;
201
- for (const instructions of [CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS, CHILD_FANOUT_BOUNDARY_INSTRUCTIONS, STRUCTURED_OUTPUT_INSTRUCTIONS]) {
202
- rewritten = rewritten.split(`\n\n${instructions}`).join("").split(instructions).join("");
203
- }
204
- return rewritten.replace(/^(?:[ \t]*\r?\n)+/, "");
205
- }
206
-
207
- type InheritedPromptOptions = { inheritProjectContext: boolean; inheritGlobalContext: boolean; inheritSkills: boolean };
208
- type ChildBoundaryOptions = { fanoutChild?: boolean; structuredOutput?: boolean };
209
-
210
- function stripInheritedPromptText(prompt: string, options: InheritedPromptOptions): string {
211
- let rewritten = prompt;
212
- if (!options.inheritProjectContext) {
213
- rewritten = stripProjectContext(rewritten);
214
- }
215
- if (!options.inheritGlobalContext) {
216
- rewritten = stripGlobalContext(rewritten);
217
- }
218
- if (!options.inheritSkills) {
219
- rewritten = stripInheritedSkills(rewritten);
220
- }
221
- return stripChildBoundaryInstructions(stripSubagentOrchestrationSkill(rewritten));
222
- }
223
-
224
- function appendChildBoundary(prompt: string, options: ChildBoundaryOptions): string {
225
- const boundary = options.fanoutChild ? CHILD_FANOUT_BOUNDARY_INSTRUCTIONS : CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS;
226
- const structured = options.structuredOutput ? `\n\n${STRUCTURED_OUTPUT_INSTRUCTIONS}` : "";
227
- // Pi's base prompt stays first so providers that recognize it by its opening still do.
228
- return `${stripChildBoundaryInstructions(prompt)}\n\n${boundary}${structured}`;
229
- }
230
-
231
- export function rewriteSubagentPrompt(prompt: string, options: InheritedPromptOptions & ChildBoundaryOptions): string {
232
- return appendChildBoundary(stripInheritedPromptText(prompt, options), options);
233
- }
234
-
235
- /** In place, so later handlers and the final render never see the removed context. */
236
- function filterChildPromptOptions(options: BeforeAgentStartEvent["systemPromptOptions"], inherited: InheritedPromptOptions): void {
237
- if (!inherited.inheritProjectContext) options.contextFiles = [];
238
- else if (!inherited.inheritGlobalContext) options.contextFiles = options.contextFiles.filter((file) => !isGlobalContextFile(file.path));
239
- options.skills = inherited.inheritSkills ? options.skills.filter((skill) => skill.name !== "pi-subagents") : [];
240
- // Role prompts can embed context, skill catalogs, or an earlier child's boundary as text.
241
- if (options.customPrompt) options.customPrompt = stripInheritedPromptText(options.customPrompt, inherited);
242
- if (options.appendSystemPrompt) options.appendSystemPrompt = stripInheritedPromptText(options.appendSystemPrompt, inherited);
243
- }
244
-
245
- function rewritesChildPrompt(config: ChildRuntimeConfig): boolean {
246
- return config.inheritProjectContext !== undefined || config.inheritGlobalContext !== undefined || config.inheritSkills !== undefined || Boolean(config.fanoutChild);
247
- }
248
-
249
- /** Installed after every other extension: a returned prompt freezes out sections added after it. */
250
- export function registerSubagentPromptBoundary(pi: ExtensionAPI, config: ChildRuntimeConfig): void {
251
- if (!rewritesChildPrompt(config)) return;
252
- pi.on("before_agent_start", (event) => {
253
- const finalized = appendChildBoundary(event.systemPrompt, { fanoutChild: config.fanoutChild, structuredOutput: Boolean(config.structuredOutput) });
254
- return finalized === event.systemPrompt ? undefined : { systemPrompt: finalized };
255
- });
256
- }
257
-
258
- function isParentOnlySubagentMessage(message: unknown): boolean {
259
- const m = message as { role?: string; customType?: string };
260
- if (m?.role !== "custom" || typeof m.customType !== "string") return false;
261
- if (m.customType === SUBAGENT_WATCHDOG_WARNING_TYPE) return true;
262
- return PARENT_ONLY_CUSTOM_MESSAGE_TYPES.has(m.customType);
263
- }
264
-
265
- function isSubagentToolResultMessage(message: unknown): boolean {
266
- const m = message as { role?: string; toolName?: string };
267
- return m?.role === "toolResult" && m.toolName === "subagent";
268
- }
269
-
270
- function isSubagentToolCallBlock(block: unknown): boolean {
271
- const b = block as { type?: string; name?: string };
272
- return b?.type === "toolCall" && b.name === "subagent";
273
- }
274
-
275
- const PORTABLE_TOOL_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
276
- const MAX_PORTABLE_TOOL_ID_LENGTH = 64;
277
- const COMPOSITE_TOOL_ID_APIS = new Set([
278
- "azure-openai-responses",
279
- "cursor-native",
280
- "openai-completions",
281
- "openai-responses",
282
- ]);
283
- const PROMPT_CACHE_KEY_APIS = new Set([
284
- "azure-openai-responses",
285
- "openai-codex-responses",
286
- "openai-completions",
287
- "openai-responses",
288
- ]);
289
-
290
- export function rewriteForkCacheProviderRequest(event: BeforeProviderRequestEvent, ctx: Pick<ExtensionContext, "model"> | undefined, forkCacheKey: string | undefined): unknown {
291
- const key = forkCacheKey?.trim();
292
- if (!key || !PROMPT_CACHE_KEY_APIS.has(ctx?.model?.api ?? "")) return undefined;
293
- if (!event || typeof event !== "object") return undefined;
294
- const payload = event.payload;
295
- if (!payload || typeof payload !== "object" || Array.isArray(payload)) return undefined;
296
- if (typeof (payload as { prompt_cache_key?: unknown }).prompt_cache_key !== "string") return undefined;
297
- return { ...payload, prompt_cache_key: key };
298
- }
299
-
300
- function portableToolId(id: string, preserveBoundedCompositeToolIds = false): string {
301
- if (PORTABLE_TOOL_ID_PATTERN.test(id) && id.length <= MAX_PORTABLE_TOOL_ID_LENGTH) return id;
302
- // Codex splits call_id|item_id on replay; each wire ID must remain portable and bounded.
303
- if (preserveBoundedCompositeToolIds) {
304
- const parts = id.split("|");
305
- if (parts.length === 2 && parts.every((part) => PORTABLE_TOOL_ID_PATTERN.test(part) && part.length <= MAX_PORTABLE_TOOL_ID_LENGTH)) return id;
306
- }
307
- const encoded = `tool_${Buffer.from(id).toString("base64url") || "empty"}`;
308
- if (encoded.length <= MAX_PORTABLE_TOOL_ID_LENGTH) return encoded;
309
- return `tool_${createHash("sha256").update(id).digest("base64url")}`;
310
- }
311
-
312
- function sanitizeToolHistoryMessage(message: unknown, preserveBoundedCompositeToolIds = false): unknown {
313
- const m = message as { role?: string; content?: unknown; toolCallId?: unknown };
314
- if (m?.role === "toolResult" && typeof m.toolCallId === "string") {
315
- const toolCallId = portableToolId(m.toolCallId, preserveBoundedCompositeToolIds);
316
- return toolCallId === m.toolCallId ? message : { ...m, toolCallId };
317
- }
318
- if (m?.role !== "assistant" || !Array.isArray(m.content)) return message;
319
- let changed = false;
320
- const content = m.content.map((block) => {
321
- const b = block as { type?: string; id?: unknown };
322
- if (b?.type !== "toolCall" || typeof b.id !== "string") return block;
323
- const id = portableToolId(b.id, preserveBoundedCompositeToolIds);
324
- if (id === b.id) return block;
325
- changed = true;
326
- return { ...b, id };
327
- });
328
- return changed ? { ...m, content } : message;
329
- }
330
-
331
- function stripAssistantSubagentToolCallBlocks(message: unknown): unknown | undefined {
332
- const m = message as { role?: string; content?: unknown };
333
- if (m?.role !== "assistant" || !Array.isArray(m.content)) return message;
334
- const filteredContent = m.content.filter((block) => !isSubagentToolCallBlock(block));
335
- if (filteredContent.length === m.content.length) return message;
336
- if (filteredContent.length === 0) return undefined;
337
- return { ...m, content: filteredContent };
338
- }
339
-
340
- export function stripParentOnlySubagentMessages(messages: unknown[], options: { sanitizeToolIds?: boolean; preserveBoundedCompositeToolIds?: boolean; preserveFanoutToolHistory?: boolean } = {}): unknown[] {
341
- const preserveCurrentFanoutToolHistory = options.preserveFanoutToolHistory === true;
342
- const sanitizeToolIds = options.sanitizeToolIds ?? true;
343
- let changed = false;
344
- const filtered: unknown[] = [];
345
- for (const message of messages) {
346
- if (isParentOnlySubagentMessage(message) || (!preserveCurrentFanoutToolHistory && isSubagentToolResultMessage(message))) {
347
- changed = true;
348
- continue;
349
- }
350
- const stripped = preserveCurrentFanoutToolHistory ? message : stripAssistantSubagentToolCallBlocks(message);
351
- if (stripped === undefined) {
352
- changed = true;
353
- continue;
354
- }
355
- const sanitized = sanitizeToolIds ? sanitizeToolHistoryMessage(stripped, options.preserveBoundedCompositeToolIds === true) : stripped;
356
- if (stripped !== message || sanitized !== stripped) changed = true;
357
- filtered.push(sanitized);
358
- }
359
- return changed ? filtered : messages;
360
- }
361
-
362
- export function formatSteerMessage(request: SteerRequest): string {
363
- return [
364
- request.mode === "follow_up" ? "Queued follow-up from the parent orchestrator:" : "Mid-run steering from the parent orchestrator:",
365
- "",
366
- request.message,
367
- "",
368
- "Incorporate this guidance at the next safe point. Do not restart the task unless the guidance explicitly asks you to.",
369
- ].join("\n");
370
- }
371
-
372
- export function registerPermissionGate(
373
- pi: ExtensionAPI,
374
- permissions: ChildPermissions | undefined,
375
- childWatchdog: ChildWatchdogConfig | undefined,
376
- requestPermission: (request: WatchdogPermissionRequest) => Promise<WatchdogPermissionResult> = requestWatchdogPermission,
377
- ): void {
378
- const rules = permissions?.rules;
379
- if (!rules || Object.keys(rules).length === 0) return;
380
- const rawWatchdogConfig = childWatchdog ? JSON.stringify(childWatchdog) : undefined;
381
- const timeoutMs = childWatchdog?.agentEndTimeoutMs ?? 30_000;
382
- const onRuntimeEvent = pi.on as unknown as (event: string, handler: (event: { toolName?: string; input?: unknown }, ctx: ExtensionContext) => unknown) => void;
383
- onRuntimeEvent("tool_call", async (event, ctx) => {
384
- const toolName = typeof event.toolName === "string" ? event.toolName : "tool";
385
- const decision = permissionDecision(rules, toolName);
386
- if (decision === "allow") return undefined;
387
- if (decision === "deny") return { block: true, reason: `Blocked by pi-subagents permission rule: '${toolName}' is denied.` };
388
- if (ctx.signal?.aborted) return { block: true, reason: "Blocked by pi-subagents permission rule: Watchdog permission decision was cancelled." };
389
- let timeout: ReturnType<typeof setTimeout> | undefined;
390
- let abort: (() => void) | undefined;
391
- let result: WatchdogPermissionResult;
392
- try {
393
- result = await Promise.race([
394
- requestPermission({
395
- ctx,
396
- toolName,
397
- args: event.input ?? {},
398
- rawWatchdogConfig,
399
- auditPath: permissions.auditPath,
400
- ...(ctx.signal ? { signal: ctx.signal } : {}),
401
- }),
402
- new Promise<WatchdogPermissionResult>((resolve) => {
403
- if (!ctx.signal) return;
404
- abort = () => resolve({ approved: false, reason: "Watchdog permission decision was cancelled.", source: "watchdog" });
405
- ctx.signal.addEventListener("abort", abort, { once: true });
406
- }),
407
- new Promise<never>((_, reject) => { timeout = setTimeout(() => reject(new Error(`Watchdog permission decision timed out after ${timeoutMs}ms.`)), timeoutMs); }),
408
- ]);
409
- } catch (error) {
410
- const reason = error instanceof Error ? error.message : String(error);
411
- return { block: true, reason: `Blocked by pi-subagents permission rule: Watchdog permission arbiter failed closed: ${reason}` };
412
- } finally {
413
- if (timeout) clearTimeout(timeout);
414
- if (abort) ctx.signal?.removeEventListener("abort", abort);
415
- }
416
- if (result.approved) return undefined;
417
- return { block: true, reason: `Blocked by pi-subagents permission rule: ${result.reason}` };
418
- });
419
- }
420
-
421
- function registerToolBudget(pi: ExtensionAPI, budget: ResolvedToolBudget | undefined): void {
422
- if (!budget) return;
423
- let toolCount = 0;
424
- let softNudged = false;
425
- const sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: "steer" }) => unknown }).sendUserMessage;
426
- const onRuntimeEvent = pi.on as unknown as (event: string, handler: (event: { toolName?: string }) => unknown) => void;
427
- onRuntimeEvent("tool_call", (event) => {
428
- const toolName = typeof event.toolName === "string" ? event.toolName : "tool";
429
- toolCount++;
430
- if (budget.soft !== undefined && toolCount >= budget.soft && !softNudged) {
431
- softNudged = true;
432
- try {
433
- sendUserMessage?.(toolBudgetSoftNudge(budget, toolCount), { deliverAs: "steer" });
434
- } catch {
435
- // Budget nudges are advisory; blocking below remains authoritative.
436
- }
437
- }
438
- if (!shouldBlockToolForBudget(budget, toolName, toolCount)) return undefined;
439
- return { block: true, reason: toolBudgetBlockedMessage(budget, toolName, toolCount) };
440
- });
441
- }
442
-
443
- function registerStructuredOutputTool(pi: ExtensionAPI, structured: NonNullable<ChildRuntimeConfig["structuredOutput"]>): void {
444
- const terminalState = structured.terminalState ??= { captured: false };
445
- const required = structured.acceptanceReport === "required";
446
- const parameters = createStructuredOutputToolParameters(structured.schema, { acceptanceReport: structured.acceptanceReport });
447
- const registerTool = pi.registerTool as unknown as (tool: {
448
- name: string;
449
- label: string;
450
- description: string;
451
- parameters: unknown;
452
- execute: (_id: string, params: { value: unknown; acceptanceReport?: unknown }) => Promise<unknown>;
453
- }) => void;
454
- registerTool({
455
- name: "structured_output",
456
- ...MODEL_ONLY_TOOL,
457
- label: "Structured Output",
458
- description: "Submit the required final structured output for this subagent step. This terminates the step.",
459
- parameters,
460
- async execute(_id: string, params: { value: unknown; acceptanceReport?: unknown }) {
461
- const validation = await validateStructuredOutputValue(structured.schema, params.value);
462
- if (validation.status === "invalid") {
463
- throw new Error(`Structured output validation failed: ${validation.message}`);
464
- }
465
- if (required && params.acceptanceReport === undefined) {
466
- throw new Error(MISSING_STRUCTURED_ACCEPTANCE_REPORT_ERROR);
467
- }
468
- if (required && params.acceptanceReport !== undefined) {
469
- const acceptanceValidation = validateAcceptanceReport(params.acceptanceReport, "acceptanceReport");
470
- if (!acceptanceValidation.report) {
471
- throw new Error(`Invalid structured output acceptance report: ${acceptanceValidation.errors.join("; ")}`);
472
- }
473
- }
474
- structured.capture(params.value, structured.acceptanceReport ? params.acceptanceReport : undefined);
475
- terminalState.captured = true;
476
- return {
477
- content: [{ type: "text", text: "Structured output captured." }],
478
- details: {},
479
- terminate: true,
480
- };
481
- },
482
- });
483
- }
484
-
485
- /** Register every child-side hook the prompt runtime owns for one child session. */
486
- export default function registerSubagentPromptRuntime(pi: ExtensionAPI, config?: ChildRuntimeConfig, drainObservation?: import("./readonly-drain-observation.ts").ReadonlyDrainObservation): void {
487
- // A path-based load has no ChildRuntimeConfig. This can happen if an
488
- // ambient-extension discovery path finds the runtime module in addition to
489
- // the configured inline factory. It must be inert rather than crashing the
490
- // child before startup; the inline factory remains the real registration path.
491
- if (!config) return;
492
- registerRuntimeExtensionAcknowledgements(pi, config.runtimeAcknowledgements);
493
- registerPermissionGate(pi, config.permissions, config.childWatchdog);
494
- registerToolBudget(pi, config.toolBudget);
495
- if (config.structuredOutput && !config.structuredOutput.terminalState) config.structuredOutput.terminalState = { captured: false };
496
- registerChildWatchdog(pi, config.childWatchdog, config.watchdogStatus, config.structuredOutput?.terminalState);
497
- const requestedWatchdogDiff = config.requiredTools?.includes(WATCHDOG_DIFF_TOOL_NAME);
498
- const reviewerLaunchBaseline = requestedWatchdogDiff && config.cwd
499
- ? captureWatchdogDiffBaseline(config.cwd)
500
- : undefined;
501
- if (requestedWatchdogDiff && typeof pi.registerTool === "function") {
502
- pi.registerTool(createWatchdogDiffTool(reviewerLaunchBaseline, { workingTreeAtLaunch: true }));
503
- }
504
- const waitState = config.runtimeState ?? {
505
- baseCwd: "",
506
- currentSessionId: null,
507
- asyncJobs: new Map(),
508
- foregroundRuns: new Map(),
509
- foregroundControls: new Map(),
510
- lastForegroundControlId: null,
511
- cleanupTimers: new Map(),
512
- lastUiContext: null,
513
- poller: null,
514
- completionSeen: new Map(),
515
- watcher: null,
516
- watcherRestartTimer: null,
517
- resultFileCoalescer: { schedule: () => false, clear: () => {} },
518
- } as unknown as SubagentState;
519
- const nestedRootRunId = inheritedNestedRouteOf(config)?.rootRunId;
520
- if (typeof pi.registerTool === "function") registerWaitTool(pi, waitState, config.waitTool.enabled, undefined, config.waitTool.defaultTimeoutMs, { nestedRootRunId });
521
- const supervisorMetadata = childSupervisorMetadata(config);
522
- let nativeSupervisorClientRegistered = false;
523
- const registerNativeSupervisorClientOnce = (): void => {
524
- if (nativeSupervisorClientRegistered) return;
525
- nativeSupervisorClientRegistered = true;
526
- registerNativeSupervisorClient(pi, supervisorMetadata);
527
- };
528
- const onRuntimeEvent = pi.on as unknown as (event: string, handler: (event: unknown, ctx?: ExtensionContext) => unknown) => void;
529
- onRuntimeEvent("session_start", (_event: unknown, ctx?: ExtensionContext) => {
530
- const sessionManager = (ctx as { sessionManager?: Parameters<typeof resolveCurrentSessionId>[0] } | undefined)?.sessionManager;
531
- waitState.currentSessionId = sessionManager ? resolveCurrentSessionId(sessionManager) : null;
532
- registerNativeSupervisorClientOnce();
533
- });
534
- onRuntimeEvent("agent_start", () => {
535
- if (!config.requiredTools) return;
536
- const diagnostic = evaluateChildToolDiagnostic(config, pi.getAllTools().map((tool) => tool.name));
537
- config.toolDiagnostic?.(diagnostic);
538
- if (diagnostic) throw new Error(formatChildToolDiagnostic(diagnostic));
539
- });
540
- onRuntimeEvent("agent_end", async (_event: unknown, ctx: unknown) => {
541
- if ((ctx as { hasUI?: boolean } | undefined)?.hasUI === true) drainObservation?.deny();
542
- if (drainObservation) {
543
- try {
544
- if ((ctx as ExtensionContext)?.sessionManager?.getSessionFile() !== waitState.currentSessionId) drainObservation.deny();
545
- } catch { drainObservation.deny(); }
546
- }
547
- config.holdFinalDrain?.(true);
548
- try {
549
- await drainOutstandingWork({ state: waitState, events: pi.events, nestedRootRunId, hasPendingSupervisorRequest: config.hasPendingSupervisorRequest }, drainObservation);
550
- } finally {
551
- config.holdFinalDrain?.(false);
552
- }
553
- });
554
- if (config.structuredOutput) registerStructuredOutputTool(pi, config.structuredOutput);
555
-
556
- onRuntimeEvent("before_provider_request", (event: unknown, ctx?: ExtensionContext) => rewriteForkCacheProviderRequest(event as BeforeProviderRequestEvent, ctx, config.forkCacheKey));
557
-
558
- onRuntimeEvent("context", (event: unknown, ctx?: ExtensionContext) => {
559
- if (!event || typeof event !== "object" || !("messages" in event) || !Array.isArray(event.messages)) return undefined;
560
- const messages = stripParentOnlySubagentMessages(event.messages, {
561
- sanitizeToolIds: !COMPOSITE_TOOL_ID_APIS.has(ctx?.model?.api ?? ""),
562
- preserveBoundedCompositeToolIds: ctx?.model?.api === "openai-codex-responses",
563
- preserveFanoutToolHistory: config.fanoutChild,
564
- });
565
- if (messages === event.messages) return undefined;
566
- return { messages };
567
- });
568
-
569
- // pi-intercom asks at session start for this session's intercom ID. Claiming
570
- // the route there frees the session name for the readable label. An older
571
- // pi-intercom never asks and routes by name, so the route stays the name.
572
- const routingName = config.intercomSessionName;
573
- let intercomIdClaimed = false;
574
- if (routingName) {
575
- pi.events.on(INTERCOM_SESSION_IDENTITY_EVENT, (request: unknown) => {
576
- if (!request || typeof request !== "object" || !("version" in request) || request.version !== 1 || !("claim" in request) || typeof request.claim !== "function") return;
577
- request.claim(routingName);
578
- intercomIdClaimed = true;
579
- });
580
- }
581
-
582
- onRuntimeEvent("before_agent_start", async (event: unknown) => {
583
- if (!event || typeof event !== "object" || !("systemPrompt" in event) || typeof event.systemPrompt !== "string") return undefined;
584
- registerNativeSupervisorClientOnce();
585
- const childSessionName = intercomIdClaimed ? config.sessionName || routingName : routingName || config.sessionName;
586
- if (childSessionName && typeof pi.setSessionName === "function") {
587
- pi.setSessionName(childSessionName);
588
- }
589
-
590
- // Filter the inputs instead of returning a prompt; the boundary hook appends the boundary last.
591
- if (!rewritesChildPrompt(config)) return;
592
- filterChildPromptOptions((event as BeforeAgentStartEvent).systemPromptOptions, {
593
- inheritProjectContext: config.inheritProjectContext ?? true,
594
- inheritGlobalContext: config.inheritGlobalContext ?? true,
595
- inheritSkills: config.inheritSkills ?? true,
596
- });
597
- });
598
- }
@@ -1,37 +0,0 @@
1
- export interface ChildToolDiagnostic {
2
- agent?: string;
3
- required: string[];
4
- available: string[];
5
- missing: string[];
6
- missingMcpDirectTools?: string[];
7
- }
8
-
9
- /**
10
- * Explain missing child tools. Foreground children run inside the parent
11
- * process and never load the parent's ambient extensions, so tools an ambient
12
- * extension registers (MCP tools, provider tools) only exist for background
13
- * children; the diagnostic says so instead of reporting a generic gap.
14
- */
15
- export function formatChildToolDiagnostic(diagnostic: ChildToolDiagnostic, options: { host?: "parent" | "runner" } = {}): string {
16
- const subject = diagnostic.agent ? `Agent '${diagnostic.agent}'` : "Subagent";
17
- if (options.host === "parent") {
18
- return [
19
- `${subject} ran as a foreground child, which never loads the parent's ambient extensions, and these child tools were unavailable: ${diagnostic.missing.join(", ")}.`,
20
- "The `tools` field is a strict allowlist; it does not load extension code.",
21
- ...(diagnostic.missingMcpDirectTools?.length
22
- ? [`MCP direct tools missing from the child registry: ${diagnostic.missingMcpDirectTools.join(", ")}.`]
23
- : []),
24
- "MCP tools require background children (`async: true`) because only they load ambient extensions.",
25
- "For extension tools a foreground child can load, add the provider path to `subagentOnlyExtensions` (child-only), `extensions`, or as a path-like entry in `tools`, while keeping each registered tool name in `tools`.",
26
- ].join("\n");
27
- }
28
- return [
29
- `${subject} requested unavailable child tools: ${diagnostic.missing.join(", ")}.`,
30
- "The `tools` field is a strict allowlist; it does not load extension code.",
31
- ...(diagnostic.missingMcpDirectTools?.length
32
- ? [`Resolved MCP direct tools missing from the child registry: ${diagnostic.missingMcpDirectTools.join(", ")}. Resolved names must match what the host or pi-mcp-adapter registers; check the MCP direct-tool registration before treating this as a tool-call failure.`]
33
- : []),
34
- "For extension tools, add the provider path to `subagentOnlyExtensions` (child-only), `extensions`, or as a path-like entry in `tools`, while keeping each registered tool name in `tools`.",
35
- "For MCP tools, verify the MCP adapter configuration and selected tool names. For builtin tools, verify the name against the installed Pi version.",
36
- ].join("\n");
37
- }