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