@xzzpig/pi-subagents 0.22.0 → 0.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1138) hide show
  1. package/CHANGELOG.md +355 -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-3U633XDZ.js +749 -0
  14. package/bundle/chunk-4QFZZV3O.js +57 -0
  15. package/bundle/chunk-62OCY2S4.js +14 -0
  16. package/bundle/chunk-6BJUEES3.js +276 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-BGIYHF2W.js +138 -0
  19. package/bundle/chunk-CTPAE36Y.js +94 -0
  20. package/bundle/chunk-D4EHT5SJ.js +14 -0
  21. package/bundle/chunk-ED55MIC2.js +1681 -0
  22. package/bundle/chunk-EUPJB4S7.js +5503 -0
  23. package/bundle/chunk-FG6SQJAR.js +940 -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-JEA2ZKUA.js +1372 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LMGQAJ3O.js +9872 -0
  30. package/bundle/chunk-LVWU2HOO.js +1234 -0
  31. package/bundle/chunk-NIXWDZZV.js +9 -0
  32. package/bundle/chunk-QXASAHIA.js +173 -0
  33. package/bundle/chunk-RB4GELQA.js +458 -0
  34. package/bundle/chunk-RU522D5W.js +1768 -0
  35. package/bundle/chunk-SLNMBXLL.js +7336 -0
  36. package/bundle/chunk-SW2VMNIU.js +526 -0
  37. package/bundle/chunk-TGLFTQWJ.js +143 -0
  38. package/bundle/chunk-TMHVDPYW.js +4132 -0
  39. package/bundle/chunk-U4ODUYAG.js +235 -0
  40. package/bundle/chunk-UKG4V45O.js +228 -0
  41. package/bundle/chunk-UQDHXMUG.js +264 -0
  42. package/bundle/chunk-V2KFIGFH.js +8774 -0
  43. package/bundle/chunk-VO3G7HI3.js +85 -0
  44. package/bundle/chunk-WPW4V6HM.js +227 -0
  45. package/bundle/chunk-WW76JRIX.js +175 -0
  46. package/bundle/chunk-X6LOM3Z4.js +4175 -0
  47. package/bundle/chunk-XA3DY6UG.js +161 -0
  48. package/bundle/chunk-Y6H2G6KX.js +1310 -0
  49. package/bundle/chunk-YFCK7H2S.js +129 -0
  50. package/bundle/chunk-YYREO77V.js +137 -0
  51. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  52. package/bundle/chunk-ZWXU5SPQ.js +16932 -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/goal-auto-continuation-gate.md +26 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -87
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1300 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/goal-auto-continue-gate.d.ts +17 -0
  196. package/src/goal-auto-continue-gate.js +61 -0
  197. package/src/goal-auto-continue-state.d.ts +22 -0
  198. package/src/goal-auto-continue-state.js +20 -0
  199. package/src/inspectors/actions.d.ts +24 -0
  200. package/src/inspectors/actions.js +182 -0
  201. package/src/inspectors/ghostty/actions.d.ts +11 -0
  202. package/src/inspectors/ghostty/actions.js +62 -0
  203. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  204. package/src/inspectors/ghostty/plugin.js +23 -0
  205. package/src/inspectors/herdr/actions.d.ts +25 -0
  206. package/src/inspectors/herdr/actions.js +133 -0
  207. package/src/inspectors/herdr/client.d.ts +41 -0
  208. package/src/inspectors/herdr/client.js +129 -0
  209. package/src/inspectors/herdr/focus.d.ts +24 -0
  210. package/src/inspectors/herdr/focus.js +49 -0
  211. package/src/inspectors/herdr/plugin.d.ts +6 -0
  212. package/src/inspectors/herdr/plugin.js +14 -0
  213. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  214. package/src/inspectors/herdr/project-panes.js +610 -0
  215. package/src/inspectors/inspector-runner.d.ts +23 -0
  216. package/src/inspectors/inspector-runner.js +161 -0
  217. package/src/inspectors/plugins.d.ts +8 -0
  218. package/src/inspectors/plugins.js +82 -0
  219. package/src/inspectors/session-roots-codec.d.ts +15 -0
  220. package/src/inspectors/session-roots-codec.js +32 -0
  221. package/src/inspectors/shell-command.d.ts +1 -0
  222. package/src/inspectors/shell-command.js +16 -0
  223. package/src/inspectors/tmux/actions.d.ts +25 -0
  224. package/src/inspectors/tmux/actions.js +181 -0
  225. package/src/inspectors/tmux/client.d.ts +27 -0
  226. package/src/inspectors/tmux/client.js +64 -0
  227. package/src/inspectors/tmux/plugin.d.ts +7 -0
  228. package/src/inspectors/tmux/plugin.js +14 -0
  229. package/src/inspectors/types.d.ts +48 -0
  230. package/src/inspectors/types.js +1 -0
  231. package/src/integrations/herdr-status.d.ts +47 -0
  232. package/src/integrations/herdr-status.js +350 -0
  233. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  234. package/src/integrations/pi-web-session-liveness.js +53 -0
  235. package/src/integrations/program-status.d.ts +30 -0
  236. package/src/integrations/program-status.js +188 -0
  237. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  238. package/src/intercom/fork-supervisor-routing.js +392 -0
  239. package/src/intercom/intercom-bridge.d.ts +58 -0
  240. package/src/intercom/intercom-bridge.js +193 -0
  241. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  242. package/src/intercom/native-supervisor-channel.js +1184 -0
  243. package/src/intercom/result-intercom.d.ts +35 -0
  244. package/src/intercom/result-intercom.js +376 -0
  245. package/src/intercom/supervisor-ui.d.ts +29 -0
  246. package/src/intercom/supervisor-ui.js +49 -0
  247. package/src/missions/actions.d.ts +54 -0
  248. package/src/missions/actions.js +400 -0
  249. package/src/missions/goal-driver.d.ts +16 -0
  250. package/src/missions/goal-driver.js +171 -0
  251. package/src/missions/lifecycle.d.ts +50 -0
  252. package/src/missions/lifecycle.js +388 -0
  253. package/src/missions/store.d.ts +21 -0
  254. package/src/missions/store.js +605 -0
  255. package/src/missions/types.d.ts +169 -0
  256. package/src/missions/types.js +9 -0
  257. package/src/missions/workflow-state.d.ts +14 -0
  258. package/src/missions/workflow-state.js +273 -0
  259. package/src/policy/authority.d.ts +9 -0
  260. package/src/policy/authority.js +41 -0
  261. package/src/profiles/profiles.d.ts +134 -0
  262. package/src/profiles/profiles.js +526 -0
  263. package/src/runs/background/active-async-capacity.d.ts +115 -0
  264. package/src/runs/background/active-async-capacity.js +517 -0
  265. package/src/runs/background/active-run-index.d.ts +12 -0
  266. package/src/runs/background/active-run-index.js +157 -0
  267. package/src/runs/background/async-execution.d.ts +306 -0
  268. package/src/runs/background/async-execution.js +2210 -0
  269. package/src/runs/background/async-job-tracker.d.ts +37 -0
  270. package/src/runs/background/async-job-tracker.js +926 -0
  271. package/src/runs/background/async-resume.d.ts +60 -0
  272. package/src/runs/background/async-resume.js +707 -0
  273. package/src/runs/background/async-retention.d.ts +45 -0
  274. package/src/runs/background/async-retention.js +932 -0
  275. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  276. package/src/runs/background/async-status-snapshot.js +26 -0
  277. package/src/runs/background/async-status.d.ts +179 -0
  278. package/src/runs/background/async-status.js +712 -0
  279. package/src/runs/background/auto-drain.d.ts +16 -0
  280. package/src/runs/background/auto-drain.js +71 -0
  281. package/src/runs/background/await-async-run.d.ts +26 -0
  282. package/src/runs/background/await-async-run.js +83 -0
  283. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  284. package/src/runs/background/binary-bootstrap.js +69 -0
  285. package/src/runs/background/boot-id.d.ts +12 -0
  286. package/src/runs/background/boot-id.js +47 -0
  287. package/src/runs/background/calendar-schedule.d.ts +26 -0
  288. package/src/runs/background/calendar-schedule.js +93 -0
  289. package/src/runs/background/chain-append.d.ts +34 -0
  290. package/src/runs/background/chain-append.js +299 -0
  291. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  292. package/src/runs/background/chain-root-attachment.js +186 -0
  293. package/src/runs/background/completion-batcher.d.ts +51 -0
  294. package/src/runs/background/completion-batcher.js +119 -0
  295. package/src/runs/background/completion-dedupe.d.ts +13 -0
  296. package/src/runs/background/completion-dedupe.js +48 -0
  297. package/src/runs/background/completion-replay.d.ts +47 -0
  298. package/src/runs/background/completion-replay.js +266 -0
  299. package/src/runs/background/control-channel.d.ts +170 -0
  300. package/src/runs/background/control-channel.js +610 -0
  301. package/src/runs/background/fleet-view.d.ts +63 -0
  302. package/src/runs/background/fleet-view.js +666 -0
  303. package/src/runs/background/index-segment.d.ts +16 -0
  304. package/src/runs/background/index-segment.js +58 -0
  305. package/src/runs/background/inspect-rpc.d.ts +64 -0
  306. package/src/runs/background/inspect-rpc.js +422 -0
  307. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  308. package/src/runs/background/interrupted-elsewhere.js +68 -0
  309. package/src/runs/background/notify.d.ts +216 -0
  310. package/src/runs/background/notify.js +1006 -0
  311. package/src/runs/background/owned-process-tree.d.ts +10 -0
  312. package/src/runs/background/owned-process-tree.js +116 -0
  313. package/src/runs/background/parallel-groups.d.ts +3 -0
  314. package/src/runs/background/parallel-groups.js +46 -0
  315. package/src/runs/background/pid-namespace.d.ts +2 -0
  316. package/src/runs/background/pid-namespace.js +19 -0
  317. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  318. package/src/runs/background/process-terminal-candidate.js +96 -0
  319. package/src/runs/background/process-terminal.d.ts +21 -0
  320. package/src/runs/background/process-terminal.js +227 -0
  321. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  322. package/src/runs/background/result-delivery-ownership.js +38 -0
  323. package/src/runs/background/result-files.d.ts +63 -0
  324. package/src/runs/background/result-files.js +629 -0
  325. package/src/runs/background/result-watcher.d.ts +92 -0
  326. package/src/runs/background/result-watcher.js +819 -0
  327. package/src/runs/background/resume-guidance.d.ts +4 -0
  328. package/src/runs/background/resume-guidance.js +57 -0
  329. package/src/runs/background/retained-children.d.ts +24 -0
  330. package/src/runs/background/retained-children.js +128 -0
  331. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  332. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  333. package/src/runs/background/run-child-session.d.ts +123 -0
  334. package/src/runs/background/run-child-session.js +670 -0
  335. package/src/runs/background/run-id-query.d.ts +3 -0
  336. package/src/runs/background/run-id-query.js +6 -0
  337. package/src/runs/background/run-id-resolver.d.ts +22 -0
  338. package/src/runs/background/run-id-resolver.js +172 -0
  339. package/src/runs/background/run-status.d.ts +25 -0
  340. package/src/runs/background/run-status.js +850 -0
  341. package/src/runs/background/runner-aliases.d.ts +17 -0
  342. package/src/runs/background/runner-aliases.js +191 -0
  343. package/src/runs/background/runner-child-launch.d.ts +24 -0
  344. package/src/runs/background/runner-child-launch.js +72 -0
  345. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  346. package/src/runs/background/runner-child-sessions.js +34 -0
  347. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  348. package/src/runs/background/runner-http-dispatcher.js +115 -0
  349. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  350. package/src/runs/background/runner-startup-failure.js +46 -0
  351. package/src/runs/background/scheduled-runs.d.ts +127 -0
  352. package/src/runs/background/scheduled-runs.js +1265 -0
  353. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  354. package/src/runs/background/stale-run-reconciler.js +509 -0
  355. package/src/runs/background/steering.d.ts +51 -0
  356. package/src/runs/background/steering.js +246 -0
  357. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  358. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  359. package/src/runs/background/subagent-runner.d.ts +210 -0
  360. package/src/runs/background/subagent-runner.js +4963 -0
  361. package/src/runs/background/subagent-wait.d.ts +124 -0
  362. package/src/runs/background/subagent-wait.js +756 -0
  363. package/src/runs/background/terminal-run-index.d.ts +10 -0
  364. package/src/runs/background/terminal-run-index.js +209 -0
  365. package/src/runs/background/top-level-async.d.ts +7 -0
  366. package/src/runs/background/top-level-async.js +5 -0
  367. package/src/runs/background/wait-completions.d.ts +28 -0
  368. package/src/runs/background/wait-completions.js +264 -0
  369. package/src/runs/background/wait-config.d.ts +8 -0
  370. package/src/runs/background/wait-config.js +46 -0
  371. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  372. package/src/runs/background/wait-subscriptions.js +339 -0
  373. package/src/runs/background/wait-tool.d.ts +6 -0
  374. package/src/runs/background/wait-tool.js +48 -0
  375. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  376. package/src/runs/background/workflow-terminal-proof.js +116 -0
  377. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  378. package/src/runs/foreground/async-dismiss-action.js +82 -0
  379. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  380. package/src/runs/foreground/async-steering-action.js +294 -0
  381. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  382. package/src/runs/foreground/async-stop-action.js +213 -0
  383. package/src/runs/foreground/command-action.d.ts +12 -0
  384. package/src/runs/foreground/command-action.js +38 -0
  385. package/src/runs/foreground/execution.d.ts +10 -0
  386. package/src/runs/foreground/execution.js +2322 -0
  387. package/src/runs/foreground/foreground-control.d.ts +24 -0
  388. package/src/runs/foreground/foreground-control.js +138 -0
  389. package/src/runs/foreground/foreground-history.d.ts +25 -0
  390. package/src/runs/foreground/foreground-history.js +267 -0
  391. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  392. package/src/runs/foreground/prompt-audit.js +138 -0
  393. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  394. package/src/runs/foreground/subagent-executor.js +7990 -0
  395. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  396. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  397. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  398. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  399. package/src/runs/shared/abort-recovery.d.ts +26 -0
  400. package/src/runs/shared/abort-recovery.js +108 -0
  401. package/src/runs/shared/acceptance.d.ts +144 -0
  402. package/src/runs/shared/acceptance.js +1616 -0
  403. package/src/runs/shared/agent-contract.d.ts +5 -0
  404. package/src/runs/shared/agent-contract.js +35 -0
  405. package/src/runs/shared/async-status-projection.d.ts +100 -0
  406. package/src/runs/shared/async-status-projection.js +566 -0
  407. package/src/runs/shared/background-process-options.d.ts +4 -0
  408. package/src/runs/shared/background-process-options.js +6 -0
  409. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  410. package/src/runs/shared/capability-ceiling.js +179 -0
  411. package/src/runs/shared/chain-outputs.d.ts +18 -0
  412. package/src/runs/shared/chain-outputs.js +104 -0
  413. package/src/runs/shared/child-commands.d.ts +29 -0
  414. package/src/runs/shared/child-commands.js +254 -0
  415. package/src/runs/shared/child-hooks.d.ts +31 -0
  416. package/src/runs/shared/child-hooks.js +173 -0
  417. package/src/runs/shared/child-identity.d.ts +23 -0
  418. package/src/runs/shared/child-identity.js +40 -0
  419. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  420. package/src/runs/shared/child-launch-plan.js +88 -0
  421. package/src/runs/shared/child-launch.d.ts +128 -0
  422. package/src/runs/shared/child-launch.js +262 -0
  423. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  424. package/src/runs/shared/child-lifecycle.js +22 -0
  425. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  426. package/src/runs/shared/child-runtime-config.js +44 -0
  427. package/src/runs/shared/child-session.d.ts +178 -0
  428. package/src/runs/shared/child-session.js +726 -0
  429. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  430. package/src/runs/shared/child-tool-plan.js +430 -0
  431. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  432. package/src/runs/shared/claude-code-adapter.js +255 -0
  433. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  434. package/src/runs/shared/codex-exec-adapter.js +127 -0
  435. package/src/runs/shared/context-mode.d.ts +12 -0
  436. package/src/runs/shared/context-mode.js +38 -0
  437. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  438. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  439. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  440. package/src/runs/shared/dynamic-fanout.js +273 -0
  441. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  442. package/src/runs/shared/effective-system-prompt.js +23 -0
  443. package/src/runs/shared/extension-bindings.d.ts +25 -0
  444. package/src/runs/shared/extension-bindings.js +96 -0
  445. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  446. package/src/runs/shared/external-cli-contract.js +145 -0
  447. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  448. package/src/runs/shared/external-cli-preflight.js +159 -0
  449. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  450. package/src/runs/shared/external-cli-runner.js +425 -0
  451. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  452. package/src/runs/shared/external-job-bridge.js +486 -0
  453. package/src/runs/shared/external-job-runner.d.ts +44 -0
  454. package/src/runs/shared/external-job-runner.js +352 -0
  455. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  456. package/src/runs/shared/fast-mode-extension.js +8 -0
  457. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  458. package/src/runs/shared/fork-placed-env.js +13 -0
  459. package/src/runs/shared/git-environment.d.ts +2 -0
  460. package/src/runs/shared/git-environment.js +27 -0
  461. package/src/runs/shared/herdr-connection.d.ts +79 -0
  462. package/src/runs/shared/herdr-connection.js +269 -0
  463. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  464. package/src/runs/shared/herdr-external-adapters.js +404 -0
  465. package/src/runs/shared/herdr-machine.d.ts +59 -0
  466. package/src/runs/shared/herdr-machine.js +294 -0
  467. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  468. package/src/runs/shared/herdr-pane-host.js +155 -0
  469. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  470. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  471. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  472. package/src/runs/shared/herdr-placed-run.js +380 -0
  473. package/src/runs/shared/host-step-status.d.ts +33 -0
  474. package/src/runs/shared/host-step-status.js +244 -0
  475. package/src/runs/shared/lane-metadata.d.ts +23 -0
  476. package/src/runs/shared/lane-metadata.js +126 -0
  477. package/src/runs/shared/launch-cwd.d.ts +1 -0
  478. package/src/runs/shared/launch-cwd.js +16 -0
  479. package/src/runs/shared/local-machine-access.d.ts +5 -0
  480. package/src/runs/shared/local-machine-access.js +28 -0
  481. package/src/runs/shared/long-running-guard.d.ts +34 -0
  482. package/src/runs/shared/long-running-guard.js +256 -0
  483. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  484. package/src/runs/shared/mcp-config-sources.js +418 -0
  485. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  486. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  487. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  488. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  489. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  490. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  491. package/src/runs/shared/model-resolution.d.ts +109 -0
  492. package/src/runs/shared/model-resolution.js +411 -0
  493. package/src/runs/shared/model-scope.d.ts +68 -0
  494. package/src/runs/shared/model-scope.js +171 -0
  495. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  496. package/src/runs/shared/mutation-evidence.js +198 -0
  497. package/src/runs/shared/nested-events.d.ts +135 -0
  498. package/src/runs/shared/nested-events.js +1090 -0
  499. package/src/runs/shared/nested-path.d.ts +8 -0
  500. package/src/runs/shared/nested-path.js +34 -0
  501. package/src/runs/shared/nested-render.d.ts +20 -0
  502. package/src/runs/shared/nested-render.js +115 -0
  503. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  504. package/src/runs/shared/orca-progress-tabs.js +503 -0
  505. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  506. package/src/runs/shared/parallel-handoff.js +783 -0
  507. package/src/runs/shared/parallel-utils.d.ts +177 -0
  508. package/src/runs/shared/parallel-utils.js +125 -0
  509. package/src/runs/shared/partial-output.d.ts +24 -0
  510. package/src/runs/shared/partial-output.js +35 -0
  511. package/src/runs/shared/permissions.d.ts +12 -0
  512. package/src/runs/shared/permissions.js +92 -0
  513. package/src/runs/shared/pi-spawn.d.ts +31 -0
  514. package/src/runs/shared/pi-spawn.js +211 -0
  515. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  516. package/src/runs/shared/placed-run-owner.js +93 -0
  517. package/src/runs/shared/placement-host.d.ts +99 -0
  518. package/src/runs/shared/placement-host.js +157 -0
  519. package/src/runs/shared/process-signal.d.ts +15 -0
  520. package/src/runs/shared/process-signal.js +21 -0
  521. package/src/runs/shared/profile-extensions.d.ts +21 -0
  522. package/src/runs/shared/profile-extensions.js +122 -0
  523. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  524. package/src/runs/shared/profile-launch-env.js +90 -0
  525. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  526. package/src/runs/shared/readonly-drain-observation.js +50 -0
  527. package/src/runs/shared/rex-machine.d.ts +25 -0
  528. package/src/runs/shared/rex-machine.js +83 -0
  529. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  530. package/src/runs/shared/rex-pane-host.js +327 -0
  531. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  532. package/src/runs/shared/run-fanout-budget.js +258 -0
  533. package/src/runs/shared/run-ownership.d.ts +3 -0
  534. package/src/runs/shared/run-ownership.js +8 -0
  535. package/src/runs/shared/runner-launcher.d.ts +11 -0
  536. package/src/runs/shared/runner-launcher.js +24 -0
  537. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  538. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  539. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  540. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  541. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  542. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  543. package/src/runs/shared/session-lease.d.ts +69 -0
  544. package/src/runs/shared/session-lease.js +250 -0
  545. package/src/runs/shared/single-output.d.ts +90 -0
  546. package/src/runs/shared/single-output.js +349 -0
  547. package/src/runs/shared/spawn-budget.d.ts +20 -0
  548. package/src/runs/shared/spawn-budget.js +93 -0
  549. package/src/runs/shared/structured-output.d.ts +66 -0
  550. package/src/runs/shared/structured-output.js +483 -0
  551. package/src/runs/shared/subagent-control.d.ts +50 -0
  552. package/src/runs/shared/subagent-control.js +247 -0
  553. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  554. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  555. package/src/runs/shared/tool-availability.d.ts +16 -0
  556. package/src/runs/shared/tool-availability.js +29 -0
  557. package/src/runs/shared/tool-budget.d.ts +21 -0
  558. package/src/runs/shared/tool-budget.js +78 -0
  559. package/src/runs/shared/tool-timeout.d.ts +31 -0
  560. package/src/runs/shared/tool-timeout.js +73 -0
  561. package/src/runs/shared/usage-budget.d.ts +7 -0
  562. package/src/runs/shared/usage-budget.js +74 -0
  563. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  564. package/src/runs/shared/usage-reconciliation.js +71 -0
  565. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  566. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  567. package/src/runs/shared/workflow-graph.d.ts +31 -0
  568. package/src/runs/shared/workflow-graph.js +221 -0
  569. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  570. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  571. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  572. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  573. package/src/runs/shared/worktree-lock.d.ts +5 -0
  574. package/src/runs/shared/worktree-lock.js +40 -0
  575. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  576. package/src/runs/shared/worktree-setup-command.js +200 -0
  577. package/src/runs/shared/worktree.d.ts +181 -0
  578. package/src/runs/shared/worktree.js +1346 -0
  579. package/src/shared/accessible-dir.d.ts +11 -0
  580. package/src/shared/accessible-dir.js +39 -0
  581. package/src/shared/agent-stream-options.d.ts +5 -0
  582. package/src/shared/agent-stream-options.js +3 -0
  583. package/src/shared/artifacts.d.ts +22 -0
  584. package/src/shared/artifacts.js +272 -0
  585. package/src/shared/atomic-json.d.ts +19 -0
  586. package/src/shared/atomic-json.js +61 -0
  587. package/src/shared/capacity-resilient-json.d.ts +26 -0
  588. package/src/shared/capacity-resilient-json.js +86 -0
  589. package/src/shared/child-cache-retention.d.ts +29 -0
  590. package/src/shared/child-cache-retention.js +40 -0
  591. package/src/shared/child-session-name.d.ts +8 -0
  592. package/src/shared/child-session-name.js +40 -0
  593. package/src/shared/child-transcript.d.ts +37 -0
  594. package/src/shared/child-transcript.js +225 -0
  595. package/src/shared/completion-owner.d.ts +7 -0
  596. package/src/shared/completion-owner.js +13 -0
  597. package/src/shared/disabled-features.d.ts +93 -0
  598. package/src/shared/disabled-features.js +120 -0
  599. package/src/shared/display-text.d.ts +5 -0
  600. package/src/shared/display-text.js +154 -0
  601. package/src/shared/edit-distance.d.ts +4 -0
  602. package/src/shared/edit-distance.js +32 -0
  603. package/src/shared/extension-context.d.ts +21 -0
  604. package/src/shared/extension-context.js +39 -0
  605. package/src/shared/file-coalescer.d.ts +11 -0
  606. package/src/shared/file-coalescer.js +34 -0
  607. package/src/shared/file-lease.d.ts +10 -0
  608. package/src/shared/file-lease.js +106 -0
  609. package/src/shared/file-system-retry.d.ts +31 -0
  610. package/src/shared/file-system-retry.js +84 -0
  611. package/src/shared/fork-context.d.ts +64 -0
  612. package/src/shared/fork-context.js +185 -0
  613. package/src/shared/fork-session-cwd.d.ts +2 -0
  614. package/src/shared/fork-session-cwd.js +23 -0
  615. package/src/shared/formatters.d.ts +35 -0
  616. package/src/shared/formatters.js +137 -0
  617. package/src/shared/jsonl-writer.d.ts +20 -0
  618. package/src/shared/jsonl-writer.js +67 -0
  619. package/src/shared/launch-contract.d.ts +65 -0
  620. package/src/shared/launch-contract.js +145 -0
  621. package/src/shared/model-info.d.ts +55 -0
  622. package/src/shared/model-info.js +103 -0
  623. package/src/shared/model-response-aliases.d.ts +1 -0
  624. package/src/shared/model-response-aliases.js +15 -0
  625. package/src/shared/node-executable.d.ts +1 -0
  626. package/src/shared/node-executable.js +20 -0
  627. package/src/shared/opencode-session-headers.d.ts +12 -0
  628. package/src/shared/opencode-session-headers.js +26 -0
  629. package/src/shared/package-version.d.ts +2 -0
  630. package/src/shared/package-version.js +14 -0
  631. package/src/shared/parent-wake.d.ts +26 -0
  632. package/src/shared/parent-wake.js +68 -0
  633. package/src/shared/permission-profile.d.ts +26 -0
  634. package/src/shared/permission-profile.js +49 -0
  635. package/src/shared/prompt-resources.d.ts +5 -0
  636. package/src/shared/prompt-resources.js +10 -0
  637. package/src/shared/provider-diagnostics.d.ts +9 -0
  638. package/src/shared/provider-diagnostics.js +75 -0
  639. package/src/shared/pruned-fork.d.ts +34 -0
  640. package/src/shared/pruned-fork.js +434 -0
  641. package/src/shared/required-child-extensions.d.ts +34 -0
  642. package/src/shared/required-child-extensions.js +105 -0
  643. package/src/shared/runtime-module-path.d.ts +10 -0
  644. package/src/shared/runtime-module-path.js +16 -0
  645. package/src/shared/sandbox-profile.d.ts +12 -0
  646. package/src/shared/sandbox-profile.js +35 -0
  647. package/src/shared/session-file-trust.d.ts +1 -0
  648. package/src/shared/session-file-trust.js +20 -0
  649. package/src/shared/session-identity.d.ts +8 -0
  650. package/src/shared/session-identity.js +32 -0
  651. package/src/shared/session-succession.d.ts +4 -0
  652. package/src/shared/session-succession.js +24 -0
  653. package/src/shared/session-tokens.d.ts +2 -0
  654. package/src/shared/session-tokens.js +58 -0
  655. package/src/shared/settings-file-lease.d.ts +4 -0
  656. package/src/shared/settings-file-lease.js +38 -0
  657. package/src/shared/settings.d.ts +146 -0
  658. package/src/shared/settings.js +247 -0
  659. package/src/shared/shortcuts.d.ts +1 -0
  660. package/src/shared/shortcuts.js +17 -0
  661. package/src/shared/status-format.d.ts +9 -0
  662. package/src/shared/status-format.js +60 -0
  663. package/src/shared/thinking-ceiling.d.ts +13 -0
  664. package/src/shared/thinking-ceiling.js +37 -0
  665. package/src/shared/types.d.ts +2842 -0
  666. package/src/shared/types.js +276 -0
  667. package/src/shared/utf8.d.ts +5 -0
  668. package/src/shared/utf8.js +12 -0
  669. package/src/shared/utils.d.ts +83 -0
  670. package/src/shared/utils.js +612 -0
  671. package/src/shared/watch-strategy.d.ts +2 -0
  672. package/src/shared/watch-strategy.js +5 -0
  673. package/src/shared/workflow-child-permit.d.ts +58 -0
  674. package/src/shared/workflow-child-permit.js +159 -0
  675. package/src/slash/delegation-adapters.d.ts +154 -0
  676. package/src/slash/delegation-adapters.js +316 -0
  677. package/src/slash/delegation-json.d.ts +10 -0
  678. package/src/slash/delegation-json.js +117 -0
  679. package/src/slash/delegation-request.d.ts +12 -0
  680. package/src/slash/delegation-request.js +174 -0
  681. package/src/slash/prompt-template-bridge.d.ts +29 -0
  682. package/src/slash/prompt-template-bridge.js +399 -0
  683. package/src/slash/prompt-workflows.d.ts +21 -0
  684. package/src/slash/prompt-workflows.js +274 -0
  685. package/src/slash/selector.d.ts +47 -0
  686. package/src/slash/selector.js +117 -0
  687. package/src/slash/slash-bridge.d.ts +30 -0
  688. package/src/slash/slash-bridge.js +132 -0
  689. package/src/slash/slash-commands.d.ts +10 -0
  690. package/src/slash/slash-commands.js +1059 -0
  691. package/src/slash/slash-live-state.d.ts +21 -0
  692. package/src/slash/slash-live-state.js +263 -0
  693. package/src/slash/subagent-cost.d.ts +29 -0
  694. package/src/slash/subagent-cost.js +310 -0
  695. package/src/slash/subagents-admin.d.ts +3 -0
  696. package/src/slash/subagents-admin.js +481 -0
  697. package/src/tui/fleet-layout.d.ts +20 -0
  698. package/src/tui/fleet-layout.js +17 -0
  699. package/src/tui/fleet-native-transcript.d.ts +53 -0
  700. package/src/tui/fleet-native-transcript.js +339 -0
  701. package/src/tui/fleet-status.d.ts +92 -0
  702. package/src/tui/fleet-status.js +1132 -0
  703. package/src/tui/fleet-transcript.d.ts +64 -0
  704. package/src/tui/fleet-transcript.js +544 -0
  705. package/src/tui/fleet-viewport.d.ts +12 -0
  706. package/src/tui/fleet-viewport.js +35 -0
  707. package/src/tui/fleet.d.ts +196 -0
  708. package/src/tui/fleet.js +1588 -0
  709. package/src/tui/mouse-events.d.ts +21 -0
  710. package/src/tui/mouse-events.js +26 -0
  711. package/src/tui/render-helpers.d.ts +23 -0
  712. package/src/tui/render-helpers.js +100 -0
  713. package/src/tui/render.d.ts +66 -0
  714. package/src/tui/render.js +3707 -0
  715. package/src/tui/running-tone.d.ts +10 -0
  716. package/src/tui/running-tone.js +22 -0
  717. package/src/tui/subagent-messages.d.ts +22 -0
  718. package/src/tui/subagent-messages.js +270 -0
  719. package/src/ui-silent-marker.d.ts +20 -0
  720. package/src/ui-silent-marker.js +25 -0
  721. package/src/watchdog/change-signature.d.ts +7 -0
  722. package/src/watchdog/change-signature.js +243 -0
  723. package/src/watchdog/child-status.d.ts +53 -0
  724. package/src/watchdog/child-status.js +187 -0
  725. package/src/watchdog/diff-tool.d.ts +25 -0
  726. package/src/watchdog/diff-tool.js +104 -0
  727. package/src/watchdog/emission-guard.d.ts +36 -0
  728. package/src/watchdog/emission-guard.js +97 -0
  729. package/src/watchdog/guidance.d.ts +3 -0
  730. package/src/watchdog/guidance.js +19 -0
  731. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  732. package/src/watchdog/lsp-diagnostics.js +489 -0
  733. package/src/watchdog/model-selection.d.ts +24 -0
  734. package/src/watchdog/model-selection.js +167 -0
  735. package/src/watchdog/permission-arbiter.d.ts +20 -0
  736. package/src/watchdog/permission-arbiter.js +135 -0
  737. package/src/watchdog/register-child.d.ts +13 -0
  738. package/src/watchdog/register-child.js +128 -0
  739. package/src/watchdog/register-main.d.ts +11 -0
  740. package/src/watchdog/register-main.js +400 -0
  741. package/src/watchdog/render.d.ts +3 -0
  742. package/src/watchdog/render.js +33 -0
  743. package/src/watchdog/review.d.ts +36 -0
  744. package/src/watchdog/review.js +319 -0
  745. package/src/watchdog/rules.d.ts +21 -0
  746. package/src/watchdog/rules.js +58 -0
  747. package/src/watchdog/runtime.d.ts +195 -0
  748. package/src/watchdog/runtime.js +864 -0
  749. package/src/watchdog/scope.d.ts +14 -0
  750. package/src/watchdog/scope.js +44 -0
  751. package/src/watchdog/settings.d.ts +29 -0
  752. package/src/watchdog/settings.js +480 -0
  753. package/src/watchdog/tool-actions.d.ts +17 -0
  754. package/src/watchdog/tool-actions.js +150 -0
  755. package/src/watchdog/turn-delta.d.ts +15 -0
  756. package/src/watchdog/turn-delta.js +188 -0
  757. package/src/watchdog/types.d.ts +141 -0
  758. package/src/watchdog/types.js +27 -0
  759. package/src/watchdog/warning-format.d.ts +7 -0
  760. package/src/watchdog/warning-format.js +59 -0
  761. package/src/workflows/chat-progress.d.ts +37 -0
  762. package/src/workflows/chat-progress.js +129 -0
  763. package/src/workflows/host-command.d.ts +30 -0
  764. package/src/workflows/host-command.js +227 -0
  765. package/src/workflows/scripted-workflow.d.ts +204 -0
  766. package/src/workflows/scripted-workflow.js +1673 -0
  767. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  768. package/src/workflows/structured-workflow-scripts.js +179 -0
  769. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  770. package/src/workflows/workflow-auto-resume.js +102 -0
  771. package/src/workflows/workflow-checklist.d.ts +127 -0
  772. package/src/workflows/workflow-checklist.js +314 -0
  773. package/src/workflows/workflow-child-summary.d.ts +24 -0
  774. package/src/workflows/workflow-child-summary.js +195 -0
  775. package/src/workflows/workflow-launch-record.d.ts +27 -0
  776. package/src/workflows/workflow-launch-record.js +48 -0
  777. package/src/workflows/workflow-preflight.d.ts +58 -0
  778. package/src/workflows/workflow-preflight.js +288 -0
  779. package/src/workflows/workflow-receipt.d.ts +34 -0
  780. package/src/workflows/workflow-receipt.js +454 -0
  781. package/src/workflows/workflow-resources.d.ts +55 -0
  782. package/src/workflows/workflow-resources.js +271 -0
  783. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  784. package/src/workflows/workflow-resume-claim.js +210 -0
  785. package/src/workflows/workflow-resume.d.ts +56 -0
  786. package/src/workflows/workflow-resume.js +106 -0
  787. package/src/workflows/workflow-reuse.d.ts +61 -0
  788. package/src/workflows/workflow-reuse.js +186 -0
  789. package/src/workflows/workflow-revival.d.ts +33 -0
  790. package/src/workflows/workflow-revival.js +111 -0
  791. package/src/workflows/workflow-settlement.d.ts +84 -0
  792. package/src/workflows/workflow-settlement.js +203 -0
  793. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  794. package/src/workflows/workflow-stop-cause.js +8 -0
  795. package/workflow-script-worker.cjs +1342 -0
  796. package/index.ts +0 -18
  797. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  798. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  799. package/skills/pi-subagents/references/execution-controls.md +0 -561
  800. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  801. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  802. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  803. package/src/agents/advertised-agent-prompt.ts +0 -82
  804. package/src/agents/agent-eject.ts +0 -339
  805. package/src/agents/agent-management.ts +0 -1442
  806. package/src/agents/agent-memory.ts +0 -341
  807. package/src/agents/agent-refinements.ts +0 -624
  808. package/src/agents/agent-scope.ts +0 -10
  809. package/src/agents/agent-selection.ts +0 -25
  810. package/src/agents/agent-serializer.ts +0 -195
  811. package/src/agents/agents.ts +0 -3169
  812. package/src/agents/builtin-names.ts +0 -16
  813. package/src/agents/chain-serializer.ts +0 -285
  814. package/src/agents/frontmatter.ts +0 -153
  815. package/src/agents/global-npm-root.ts +0 -58
  816. package/src/agents/identity.ts +0 -30
  817. package/src/agents/proactive-skills.ts +0 -197
  818. package/src/agents/runtime-agent-events.ts +0 -70
  819. package/src/agents/runtime-agent-registry.ts +0 -457
  820. package/src/agents/runtime-discovery.ts +0 -39
  821. package/src/agents/skills.ts +0 -787
  822. package/src/api/agent-management.ts +0 -9
  823. package/src/api/agents.ts +0 -19
  824. package/src/api/background-work.ts +0 -206
  825. package/src/api/capability-ceiling.ts +0 -16
  826. package/src/api/child-tool-plan.ts +0 -5
  827. package/src/api/control-channel.ts +0 -4
  828. package/src/api/delegation.ts +0 -131
  829. package/src/api/external-job-provider.ts +0 -195
  830. package/src/api/external-runs.ts +0 -282
  831. package/src/api/inspectors.ts +0 -27
  832. package/src/api/intercom-bridge.ts +0 -3
  833. package/src/api/preflight.ts +0 -641
  834. package/src/api/project-panes.ts +0 -32
  835. package/src/api/required-child-extensions.ts +0 -6
  836. package/src/api/shared-types.ts +0 -29
  837. package/src/api/supervisor-routing.ts +0 -196
  838. package/src/api/workflow-resources.ts +0 -6
  839. package/src/extension/config.ts +0 -262
  840. package/src/extension/context-injection.ts +0 -123
  841. package/src/extension/control-notices.ts +0 -53
  842. package/src/extension/declaration-pinning.ts +0 -164
  843. package/src/extension/doctor.ts +0 -284
  844. package/src/extension/fanout-child.ts +0 -282
  845. package/src/extension/herdr-pi-bridge.ts +0 -166
  846. package/src/extension/index.ts +0 -1212
  847. package/src/extension/public-execution.ts +0 -262
  848. package/src/extension/reply-workflow-script.ts +0 -67
  849. package/src/extension/rpc.ts +0 -881
  850. package/src/extension/schemas.ts +0 -337
  851. package/src/extension/steering-notices.ts +0 -35
  852. package/src/extension/subagent-guide.ts +0 -127
  853. package/src/extension/subagent-options.ts +0 -47
  854. package/src/extension/tool-activation.ts +0 -147
  855. package/src/extension/tool-description.ts +0 -193
  856. package/src/extension/tool-result.ts +0 -19
  857. package/src/extension/upgrade-notice.ts +0 -40
  858. package/src/inspectors/actions.ts +0 -174
  859. package/src/inspectors/ghostty/actions.ts +0 -74
  860. package/src/inspectors/ghostty/plugin.ts +0 -29
  861. package/src/inspectors/herdr/actions.ts +0 -155
  862. package/src/inspectors/herdr/client.ts +0 -130
  863. package/src/inspectors/herdr/focus.ts +0 -55
  864. package/src/inspectors/herdr/plugin.ts +0 -20
  865. package/src/inspectors/herdr/project-panes.ts +0 -733
  866. package/src/inspectors/inspector-runner.ts +0 -153
  867. package/src/inspectors/plugins.ts +0 -76
  868. package/src/inspectors/session-roots-codec.ts +0 -31
  869. package/src/inspectors/shell-command.ts +0 -16
  870. package/src/inspectors/tmux/actions.ts +0 -204
  871. package/src/inspectors/tmux/client.ts +0 -85
  872. package/src/inspectors/tmux/plugin.ts +0 -21
  873. package/src/inspectors/types.ts +0 -51
  874. package/src/integrations/herdr-status.ts +0 -385
  875. package/src/integrations/pi-web-session-liveness.ts +0 -73
  876. package/src/integrations/program-status.ts +0 -215
  877. package/src/intercom/fork-supervisor-routing.ts +0 -533
  878. package/src/intercom/intercom-bridge.ts +0 -235
  879. package/src/intercom/native-supervisor-channel.ts +0 -1066
  880. package/src/intercom/result-intercom.ts +0 -433
  881. package/src/intercom/supervisor-ui.ts +0 -72
  882. package/src/missions/actions.ts +0 -433
  883. package/src/missions/goal-driver.ts +0 -177
  884. package/src/missions/lifecycle.ts +0 -367
  885. package/src/missions/store.ts +0 -613
  886. package/src/missions/types.ts +0 -190
  887. package/src/missions/workflow-state.ts +0 -281
  888. package/src/policy/authority.ts +0 -50
  889. package/src/profiles/profiles.ts +0 -674
  890. package/src/runs/background/active-async-capacity.ts +0 -548
  891. package/src/runs/background/active-run-index.ts +0 -155
  892. package/src/runs/background/async-execution.ts +0 -2479
  893. package/src/runs/background/async-job-tracker.ts +0 -869
  894. package/src/runs/background/async-resume.ts +0 -686
  895. package/src/runs/background/async-retention.ts +0 -953
  896. package/src/runs/background/async-status-snapshot.ts +0 -46
  897. package/src/runs/background/async-status.ts +0 -787
  898. package/src/runs/background/auto-drain.ts +0 -92
  899. package/src/runs/background/await-async-run.ts +0 -83
  900. package/src/runs/background/binary-bootstrap.ts +0 -67
  901. package/src/runs/background/calendar-schedule.ts +0 -90
  902. package/src/runs/background/chain-append.ts +0 -321
  903. package/src/runs/background/chain-root-attachment.ts +0 -263
  904. package/src/runs/background/completion-batcher.ts +0 -168
  905. package/src/runs/background/completion-dedupe.ts +0 -58
  906. package/src/runs/background/completion-replay.ts +0 -287
  907. package/src/runs/background/control-channel.ts +0 -659
  908. package/src/runs/background/fleet-view.ts +0 -692
  909. package/src/runs/background/index-segment.ts +0 -59
  910. package/src/runs/background/inspect-rpc.ts +0 -443
  911. package/src/runs/background/notify.ts +0 -1083
  912. package/src/runs/background/owned-process-tree.ts +0 -131
  913. package/src/runs/background/parallel-groups.ts +0 -45
  914. package/src/runs/background/pid-namespace.ts +0 -18
  915. package/src/runs/background/process-terminal-candidate.ts +0 -98
  916. package/src/runs/background/process-terminal.ts +0 -231
  917. package/src/runs/background/result-delivery-ownership.ts +0 -45
  918. package/src/runs/background/result-files.ts +0 -634
  919. package/src/runs/background/result-watcher.ts +0 -842
  920. package/src/runs/background/resume-guidance.ts +0 -56
  921. package/src/runs/background/retained-children.ts +0 -136
  922. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  923. package/src/runs/background/run-child-session.ts +0 -725
  924. package/src/runs/background/run-id-query.ts +0 -7
  925. package/src/runs/background/run-id-resolver.ts +0 -183
  926. package/src/runs/background/run-status.ts +0 -803
  927. package/src/runs/background/runner-aliases.ts +0 -183
  928. package/src/runs/background/runner-child-launch.ts +0 -96
  929. package/src/runs/background/runner-child-sessions.ts +0 -32
  930. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  931. package/src/runs/background/runner-startup-failure.ts +0 -56
  932. package/src/runs/background/scheduled-runs.ts +0 -1222
  933. package/src/runs/background/stale-run-reconciler.ts +0 -463
  934. package/src/runs/background/steering.ts +0 -260
  935. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  936. package/src/runs/background/subagent-runner.ts +0 -5251
  937. package/src/runs/background/subagent-wait.ts +0 -895
  938. package/src/runs/background/terminal-run-index.ts +0 -183
  939. package/src/runs/background/top-level-async.ts +0 -14
  940. package/src/runs/background/wait-completions.ts +0 -262
  941. package/src/runs/background/wait-config.ts +0 -50
  942. package/src/runs/background/wait-subscriptions.ts +0 -354
  943. package/src/runs/background/wait-tool.ts +0 -57
  944. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  945. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  946. package/src/runs/foreground/async-steering-action.ts +0 -276
  947. package/src/runs/foreground/async-stop-action.ts +0 -216
  948. package/src/runs/foreground/command-action.ts +0 -41
  949. package/src/runs/foreground/execution.ts +0 -2315
  950. package/src/runs/foreground/foreground-control.ts +0 -157
  951. package/src/runs/foreground/foreground-history.ts +0 -164
  952. package/src/runs/foreground/prompt-audit.ts +0 -172
  953. package/src/runs/foreground/subagent-executor.ts +0 -8252
  954. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  955. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  956. package/src/runs/shared/abort-recovery.ts +0 -119
  957. package/src/runs/shared/acceptance.ts +0 -1664
  958. package/src/runs/shared/agent-contract.ts +0 -38
  959. package/src/runs/shared/async-status-projection.ts +0 -664
  960. package/src/runs/shared/background-process-options.ts +0 -9
  961. package/src/runs/shared/capability-ceiling.ts +0 -214
  962. package/src/runs/shared/chain-outputs.ts +0 -116
  963. package/src/runs/shared/child-commands.ts +0 -229
  964. package/src/runs/shared/child-hooks.ts +0 -175
  965. package/src/runs/shared/child-identity.ts +0 -62
  966. package/src/runs/shared/child-launch-plan.ts +0 -163
  967. package/src/runs/shared/child-launch.ts +0 -389
  968. package/src/runs/shared/child-lifecycle.ts +0 -28
  969. package/src/runs/shared/child-runtime-config.ts +0 -136
  970. package/src/runs/shared/child-session.ts +0 -699
  971. package/src/runs/shared/child-tool-plan.ts +0 -599
  972. package/src/runs/shared/claude-code-adapter.ts +0 -288
  973. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  974. package/src/runs/shared/context-mode.ts +0 -44
  975. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  976. package/src/runs/shared/dynamic-fanout.ts +0 -297
  977. package/src/runs/shared/effective-system-prompt.ts +0 -33
  978. package/src/runs/shared/extension-bindings.ts +0 -103
  979. package/src/runs/shared/external-cli-contract.ts +0 -177
  980. package/src/runs/shared/external-cli-preflight.ts +0 -190
  981. package/src/runs/shared/external-cli-runner.ts +0 -437
  982. package/src/runs/shared/external-job-bridge.ts +0 -514
  983. package/src/runs/shared/external-job-runner.ts +0 -389
  984. package/src/runs/shared/fast-mode-extension.ts +0 -10
  985. package/src/runs/shared/fork-command-result.ts +0 -10
  986. package/src/runs/shared/git-environment.ts +0 -29
  987. package/src/runs/shared/herdr-connection.ts +0 -134
  988. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  989. package/src/runs/shared/herdr-machine.ts +0 -279
  990. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  991. package/src/runs/shared/herdr-placed-run.ts +0 -264
  992. package/src/runs/shared/host-step-status.ts +0 -231
  993. package/src/runs/shared/lane-metadata.ts +0 -126
  994. package/src/runs/shared/launch-cwd.ts +0 -16
  995. package/src/runs/shared/long-running-guard.ts +0 -221
  996. package/src/runs/shared/mcp-config-sources.ts +0 -426
  997. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  998. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  999. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  1000. package/src/runs/shared/model-resolution.ts +0 -503
  1001. package/src/runs/shared/model-scope.ts +0 -224
  1002. package/src/runs/shared/mutation-evidence.ts +0 -199
  1003. package/src/runs/shared/nested-events.ts +0 -1125
  1004. package/src/runs/shared/nested-path.ts +0 -38
  1005. package/src/runs/shared/nested-render.ts +0 -127
  1006. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1007. package/src/runs/shared/parallel-handoff.ts +0 -789
  1008. package/src/runs/shared/parallel-utils.ts +0 -292
  1009. package/src/runs/shared/partial-output.ts +0 -48
  1010. package/src/runs/shared/permissions.ts +0 -86
  1011. package/src/runs/shared/pi-spawn.ts +0 -205
  1012. package/src/runs/shared/process-signal.ts +0 -35
  1013. package/src/runs/shared/profile-extensions.ts +0 -134
  1014. package/src/runs/shared/profile-launch-env.ts +0 -121
  1015. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1016. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1017. package/src/runs/shared/run-history.ts +0 -288
  1018. package/src/runs/shared/runner-launcher.ts +0 -25
  1019. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1020. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1021. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1022. package/src/runs/shared/session-lease.ts +0 -293
  1023. package/src/runs/shared/single-output.ts +0 -366
  1024. package/src/runs/shared/spawn-budget.ts +0 -128
  1025. package/src/runs/shared/structured-output.ts +0 -463
  1026. package/src/runs/shared/subagent-control.ts +0 -295
  1027. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1028. package/src/runs/shared/tool-availability.ts +0 -37
  1029. package/src/runs/shared/tool-budget.ts +0 -87
  1030. package/src/runs/shared/tool-timeout.ts +0 -93
  1031. package/src/runs/shared/usage-budget.ts +0 -65
  1032. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1033. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1034. package/src/runs/shared/workflow-graph.ts +0 -225
  1035. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1036. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1037. package/src/runs/shared/worktree-lock.ts +0 -29
  1038. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1039. package/src/runs/shared/worktree.ts +0 -1554
  1040. package/src/shared/accessible-dir.ts +0 -47
  1041. package/src/shared/agent-stream-options.ts +0 -5
  1042. package/src/shared/artifacts.ts +0 -281
  1043. package/src/shared/atomic-json.ts +0 -85
  1044. package/src/shared/capacity-resilient-json.ts +0 -102
  1045. package/src/shared/child-cache-retention.ts +0 -43
  1046. package/src/shared/child-session-name.ts +0 -48
  1047. package/src/shared/child-transcript.ts +0 -264
  1048. package/src/shared/completion-owner.ts +0 -14
  1049. package/src/shared/disabled-features.ts +0 -123
  1050. package/src/shared/display-text.ts +0 -150
  1051. package/src/shared/edit-distance.ts +0 -33
  1052. package/src/shared/extension-context.ts +0 -37
  1053. package/src/shared/file-coalescer.ts +0 -49
  1054. package/src/shared/file-lease.ts +0 -74
  1055. package/src/shared/file-system-retry.ts +0 -95
  1056. package/src/shared/fork-context.ts +0 -243
  1057. package/src/shared/fork-session-cwd.ts +0 -27
  1058. package/src/shared/formatters.ts +0 -142
  1059. package/src/shared/jsonl-writer.ts +0 -92
  1060. package/src/shared/launch-contract.ts +0 -206
  1061. package/src/shared/model-info.ts +0 -132
  1062. package/src/shared/model-response-aliases.ts +0 -13
  1063. package/src/shared/node-executable.ts +0 -21
  1064. package/src/shared/opencode-session-headers.ts +0 -30
  1065. package/src/shared/package-version.ts +0 -17
  1066. package/src/shared/parent-wake.ts +0 -79
  1067. package/src/shared/permission-profile.ts +0 -56
  1068. package/src/shared/prompt-resources.ts +0 -11
  1069. package/src/shared/pruned-fork.ts +0 -469
  1070. package/src/shared/required-child-extensions.ts +0 -115
  1071. package/src/shared/runtime-module-path.ts +0 -19
  1072. package/src/shared/sandbox-profile.ts +0 -37
  1073. package/src/shared/session-file-trust.ts +0 -19
  1074. package/src/shared/session-identity.ts +0 -10
  1075. package/src/shared/session-tokens.ts +0 -55
  1076. package/src/shared/settings-file-lease.ts +0 -36
  1077. package/src/shared/settings.ts +0 -412
  1078. package/src/shared/shortcuts.ts +0 -13
  1079. package/src/shared/status-format.ts +0 -55
  1080. package/src/shared/thinking-ceiling.ts +0 -46
  1081. package/src/shared/types.ts +0 -3105
  1082. package/src/shared/utf8.ts +0 -11
  1083. package/src/shared/utils.ts +0 -610
  1084. package/src/shared/watch-strategy.ts +0 -12
  1085. package/src/shared/workflow-child-permit.ts +0 -212
  1086. package/src/slash/delegation-adapters.ts +0 -452
  1087. package/src/slash/delegation-json.ts +0 -108
  1088. package/src/slash/delegation-request.ts +0 -176
  1089. package/src/slash/prompt-template-bridge.ts +0 -435
  1090. package/src/slash/prompt-workflows.ts +0 -298
  1091. package/src/slash/selector.ts +0 -147
  1092. package/src/slash/slash-bridge.ts +0 -192
  1093. package/src/slash/slash-commands.ts +0 -1096
  1094. package/src/slash/slash-live-state.ts +0 -310
  1095. package/src/slash/subagent-cost.ts +0 -317
  1096. package/src/slash/subagents-admin.ts +0 -489
  1097. package/src/tui/fleet-native-transcript.ts +0 -424
  1098. package/src/tui/fleet-status.ts +0 -1139
  1099. package/src/tui/fleet-transcript.ts +0 -591
  1100. package/src/tui/fleet.ts +0 -1618
  1101. package/src/tui/mouse-events.ts +0 -42
  1102. package/src/tui/render-helpers.ts +0 -111
  1103. package/src/tui/render.ts +0 -3824
  1104. package/src/tui/running-tone.ts +0 -28
  1105. package/src/tui/subagent-messages.ts +0 -305
  1106. package/src/ui-silent-marker.ts +0 -32
  1107. package/src/watchdog/change-signature.ts +0 -260
  1108. package/src/watchdog/child-status.ts +0 -225
  1109. package/src/watchdog/diff-tool.ts +0 -112
  1110. package/src/watchdog/emission-guard.ts +0 -125
  1111. package/src/watchdog/guidance.ts +0 -20
  1112. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1113. package/src/watchdog/model-selection.ts +0 -187
  1114. package/src/watchdog/permission-arbiter.ts +0 -154
  1115. package/src/watchdog/register-child.ts +0 -136
  1116. package/src/watchdog/register-main.ts +0 -425
  1117. package/src/watchdog/render.ts +0 -31
  1118. package/src/watchdog/review.ts +0 -362
  1119. package/src/watchdog/rules.ts +0 -70
  1120. package/src/watchdog/runtime.ts +0 -927
  1121. package/src/watchdog/scope.ts +0 -51
  1122. package/src/watchdog/settings.ts +0 -520
  1123. package/src/watchdog/tool-actions.ts +0 -156
  1124. package/src/watchdog/turn-delta.ts +0 -190
  1125. package/src/watchdog/types.ts +0 -186
  1126. package/src/watchdog/warning-format.ts +0 -72
  1127. package/src/workflows/chat-progress.ts +0 -152
  1128. package/src/workflows/host-command.ts +0 -235
  1129. package/src/workflows/scripted-workflow.ts +0 -2733
  1130. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1131. package/src/workflows/workflow-checklist.ts +0 -442
  1132. package/src/workflows/workflow-child-summary.ts +0 -172
  1133. package/src/workflows/workflow-preflight.ts +0 -297
  1134. package/src/workflows/workflow-receipt.ts +0 -390
  1135. package/src/workflows/workflow-resources.ts +0 -275
  1136. package/src/workflows/workflow-reuse.ts +0 -120
  1137. package/src/workflows/workflow-revival.ts +0 -123
  1138. package/src/workflows/workflow-settlement.ts +0 -252
@@ -0,0 +1,211 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import { fileURLToPath } from "node:url";
4
+ import { PI_CODING_AGENT_PACKAGE_ROOT_ENV } from "../../shared/utils.js";
5
+ export const PI_CODING_AGENT_PACKAGE = "@earendil-works/pi-coding-agent";
6
+ export const PI_SUBAGENT_PI_BINARY_ENV = "PI_SUBAGENT_PI_BINARY";
7
+ export function findPiPackageRootFromEntry(entryPoint) {
8
+ let dir = path.dirname(entryPoint);
9
+ while (dir !== path.dirname(dir)) {
10
+ const packageJsonPath = path.join(dir, "package.json");
11
+ if (fs.existsSync(packageJsonPath)) {
12
+ const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
13
+ if (pkg.name === PI_CODING_AGENT_PACKAGE)
14
+ return dir;
15
+ }
16
+ dir = path.dirname(dir);
17
+ }
18
+ return undefined;
19
+ }
20
+ export function resolveInstalledPiPackageRoot() {
21
+ try {
22
+ return findPiPackageRootFromEntry(fileURLToPath(import.meta.resolve(PI_CODING_AGENT_PACKAGE)));
23
+ }
24
+ catch {
25
+ return undefined;
26
+ }
27
+ }
28
+ export function resolvePiPackageRoot(entry = process.argv[1]) {
29
+ try {
30
+ return entry
31
+ ? findPiPackageRootFromEntry(fs.realpathSync(entry))
32
+ : undefined;
33
+ }
34
+ catch {
35
+ // process.argv[1] probing is best-effort; callers can fall back to PATH/package resolution.
36
+ return undefined;
37
+ }
38
+ }
39
+ /** Resolve only the canonical host entry's local dependency graph, not NODE_PATH/global stores. */
40
+ export function resolveHostDependencyPiPackageRoot(entry = process.argv[1]) {
41
+ let canonicalEntry;
42
+ try {
43
+ if (!entry)
44
+ return undefined;
45
+ canonicalEntry = fs.realpathSync(entry);
46
+ }
47
+ catch {
48
+ return undefined;
49
+ }
50
+ let dir = path.dirname(canonicalEntry);
51
+ for (;;) {
52
+ const root = path.join(dir, "node_modules", PI_CODING_AGENT_PACKAGE);
53
+ try {
54
+ fs.lstatSync(root);
55
+ }
56
+ catch (error) {
57
+ // ENOTDIR: a file named node_modules is not a candidate, so keep walking like Node's resolver.
58
+ const code = error.code;
59
+ if (code !== "ENOENT" && code !== "ENOTDIR")
60
+ throw error;
61
+ const parent = path.dirname(dir);
62
+ if (parent === dir)
63
+ return undefined;
64
+ dir = parent;
65
+ continue;
66
+ }
67
+ // The nearest candidate is authoritative, even with a broken link or manifest.
68
+ const canonicalRoot = fs.realpathSync(root);
69
+ readPiPackageJson(path.join(canonicalRoot, "package.json"));
70
+ return canonicalRoot;
71
+ }
72
+ }
73
+ /** One SDK root for foreground imports and detached peer aliases; never retry a selected root. */
74
+ export function resolveHostPiPackageRoot(deps = {}) {
75
+ return selectPiPackage(deps)?.root;
76
+ }
77
+ /** Compiled Pi's entrypoint is virtual; execPath is the real (possibly renamed) image. */
78
+ export function resolveBunPiExecutable(deps = {}) {
79
+ const bunVersion = deps.bunVersion ?? process.versions.bun;
80
+ const entry = deps.argv1 ?? process.argv[1];
81
+ if (!bunVersion || !entry || !/^(?:\/\$bunfs\/|B:[\\/]~BUN[\\/])/.test(entry))
82
+ return undefined;
83
+ const env = deps.env ?? process.env;
84
+ return env[PI_SUBAGENT_PI_BINARY_ENV]?.trim() || (deps.execPath ?? process.execPath);
85
+ }
86
+ function isNodeScriptPath(filePath) {
87
+ return /\.(?:mjs|cjs|js)$/i.test(filePath);
88
+ }
89
+ function isRunnableNodeScript(filePath, existsSync) {
90
+ if (!existsSync(filePath))
91
+ return false;
92
+ return isNodeScriptPath(filePath);
93
+ }
94
+ function normalizePath(filePath) {
95
+ return path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
96
+ }
97
+ function isStandalonePiExecutable(execPath) {
98
+ const executableName = execPath.split(/[\\/]/).pop();
99
+ return /^pi(?:\.exe)?$/i.test(executableName ?? "");
100
+ }
101
+ function readPiPackageJson(packageJsonPath, readFileSync = (filePath, encoding) => fs.readFileSync(filePath, encoding)) {
102
+ const source = readFileSync(packageJsonPath, "utf-8");
103
+ let pkg;
104
+ try {
105
+ pkg = JSON.parse(source);
106
+ }
107
+ catch (error) {
108
+ throw new Error(`invalid host SDK manifest at ${packageJsonPath}: malformed JSON`, { cause: error });
109
+ }
110
+ if (!pkg || typeof pkg !== "object" || Array.isArray(pkg)) {
111
+ throw new Error(`invalid host SDK manifest at ${packageJsonPath}: expected a JSON object`);
112
+ }
113
+ if (pkg.name !== PI_CODING_AGENT_PACKAGE) {
114
+ throw new Error(`invalid host SDK manifest at ${packageJsonPath}: expected "${PI_CODING_AGENT_PACKAGE}"`);
115
+ }
116
+ return pkg;
117
+ }
118
+ /** Preserve direct JS launches; extensionless .bin/pi launchers must honor explicit roots first. */
119
+ function selectPiPackage(deps) {
120
+ const existsSync = deps.existsSync ?? fs.existsSync;
121
+ const realpathSync = deps.realpathSync ?? fs.realpathSync;
122
+ const argv1 = deps.argv1 ?? process.argv[1];
123
+ const env = deps.env ?? process.env;
124
+ if (argv1) {
125
+ const argvPath = normalizePath(argv1);
126
+ if (isRunnableNodeScript(argvPath, existsSync)) {
127
+ try {
128
+ const canonicalArgvPath = realpathSync(argvPath);
129
+ const root = isRunnableNodeScript(canonicalArgvPath, existsSync)
130
+ ? findPiPackageRootFromEntry(canonicalArgvPath) : undefined;
131
+ if (root)
132
+ return { root, cliScript: canonicalArgvPath };
133
+ }
134
+ catch {
135
+ // Ownership probing is best-effort; an unverified host entry is not a Pi CLI.
136
+ }
137
+ }
138
+ }
139
+ const root = (deps.piPackageRoot?.trim() || undefined)
140
+ ?? (env[PI_CODING_AGENT_PACKAGE_ROOT_ENV]?.trim() || undefined)
141
+ ?? resolvePiPackageRoot(argv1)
142
+ ?? resolveHostDependencyPiPackageRoot(argv1);
143
+ if (root)
144
+ return { root, packageJson: readPiPackageJson(path.join(root, "package.json"), deps.readFileSync), authoritative: true };
145
+ // Only extension-relative discovery is best-effort, for both SDK and CLI consumers.
146
+ const packageJsonCandidates = [];
147
+ if (deps.resolvePackageJson)
148
+ packageJsonCandidates.push(deps.resolvePackageJson);
149
+ packageJsonCandidates.push(() => {
150
+ const packageRoot = deps.resolvePackageEntry
151
+ ? findPiPackageRootFromEntry(deps.resolvePackageEntry())
152
+ : resolveInstalledPiPackageRoot();
153
+ return packageRoot ? path.join(packageRoot, "package.json") : undefined;
154
+ });
155
+ for (const candidatePackageJson of packageJsonCandidates) {
156
+ try {
157
+ const packageJsonPath = candidatePackageJson();
158
+ if (!packageJsonPath)
159
+ continue;
160
+ return { root: path.dirname(packageJsonPath), packageJson: readPiPackageJson(packageJsonPath, deps.readFileSync), authoritative: false };
161
+ }
162
+ catch {
163
+ // No authoritative host root was found; keep probing the extension install.
164
+ }
165
+ }
166
+ return undefined;
167
+ }
168
+ export function resolvePiCliScript(deps = {}) {
169
+ const selection = selectPiPackage(deps);
170
+ if (!selection)
171
+ return undefined;
172
+ if ("cliScript" in selection)
173
+ return selection.cliScript;
174
+ const binField = selection.packageJson.bin;
175
+ const binPath = typeof binField === "string" ? binField : (binField?.pi ?? Object.values(binField ?? {})[0]);
176
+ const cli = binPath ? path.resolve(selection.root, binPath) : undefined;
177
+ if (cli && isRunnableNodeScript(cli, deps.existsSync ?? fs.existsSync))
178
+ return cli;
179
+ if (selection.authoritative)
180
+ throw new Error(`Selected Pi package at ${selection.root} has no runnable CLI script`);
181
+ return undefined;
182
+ }
183
+ export function getPiSpawnCommand(args, deps = {}) {
184
+ const platform = deps.platform ?? process.platform;
185
+ const env = deps.env ?? process.env;
186
+ const piBinary = env[PI_SUBAGENT_PI_BINARY_ENV]?.trim();
187
+ if (piBinary) {
188
+ if (platform === "win32" && isNodeScriptPath(piBinary)) {
189
+ return {
190
+ command: deps.execPath ?? process.execPath,
191
+ args: [piBinary, ...args],
192
+ };
193
+ }
194
+ return { command: piBinary, args };
195
+ }
196
+ const execPath = deps.execPath ?? process.execPath;
197
+ if (isStandalonePiExecutable(execPath)) {
198
+ return { command: execPath, args };
199
+ }
200
+ const piCliPath = resolvePiCliScript(deps);
201
+ if (piCliPath) {
202
+ return {
203
+ command: execPath,
204
+ args: [piCliPath, ...args],
205
+ };
206
+ }
207
+ if (platform === "win32") {
208
+ throw new Error(`Could not resolve the Pi CLI on Windows. Set ${PI_SUBAGENT_PI_BINARY_ENV} or ensure ${PI_CODING_AGENT_PACKAGE} is installed.`);
209
+ }
210
+ return { command: "pi", args };
211
+ }
@@ -0,0 +1,49 @@
1
+ import type { PlacementMachineReference } from "../../shared/types.ts";
2
+ import type { HerdrRunIdentity, HerdrRunSnapshot } from "./herdr-placed-run.ts";
3
+ import type { PlacementCommandOptions, PlacementLaunchRequest, PlacementMachineAccess, PlacementOwnedPane, PlacementPaneHost, PlacementSockets, PlacementStartOptions } from "./placement-host.ts";
4
+ export interface PlacedBridgeManifest {
5
+ socketPath: string;
6
+ nativeSessionId: string;
7
+ packageVersion: string;
8
+ protocol: number;
9
+ }
10
+ /** Prints `$1/manifest.json` when it is a regular file, never through a symlink. */
11
+ export declare const PLACED_MANIFEST_READ_SCRIPT = "p=\"$1/manifest.json\"; test -f \"$p\" && test ! -L \"$p\" && cat \"$p\"";
12
+ export declare function discoverPlacedBridgeManifest(access: PlacementMachineAccess, runId: string, runtimeDir: string, missing?: string): Promise<PlacedBridgeManifest>;
13
+ export declare function createPlacedRuntimeDir(access: PlacementMachineAccess, runId: string): Promise<string>;
14
+ export declare function removePlacedRuntimeDir(access: PlacementMachineAccess, runtimeDir: string): void;
15
+ /** The single private owner for allocation shared by every pane-native backend projection. */
16
+ export declare class PlacedRunOwner<C extends PlacementSockets, M extends PlacementMachineReference = PlacementMachineReference> {
17
+ #private;
18
+ readonly machine: M;
19
+ readonly runId: string;
20
+ readonly runtimeDir: string;
21
+ connection: C;
22
+ readonly host: PlacementPaneHost<C>;
23
+ readonly access: PlacementMachineAccess;
24
+ owned?: PlacementOwnedPane;
25
+ terminalId?: string;
26
+ agentName?: string;
27
+ startedArgv?: string[];
28
+ identity?: HerdrRunIdentity;
29
+ protected constructor(machine: M, runId: string, runtimeDir: string, connection: C, host: PlacementPaneHost<C>, access: PlacementMachineAccess, removeRuntime?: () => void);
30
+ observeEvent(event: unknown): void;
31
+ markConnectionUnknown(observed: C): boolean;
32
+ subscribe(listener: (event: unknown) => void, disconnected: (error: Error) => void): Promise<void>;
33
+ /** Create the owned pane and start the agent in one host step; onPane runs once the pane exists and before the agent starts. */
34
+ launch(request: PlacementLaunchRequest, onPane: (owned: PlacementOwnedPane) => Promise<void>, options?: PlacementStartOptions): Promise<{
35
+ owned: PlacementOwnedPane;
36
+ terminalId: string;
37
+ argv: string[];
38
+ }>;
39
+ journal(identity: HerdrRunIdentity): void;
40
+ get snapshot(): HerdrRunSnapshot;
41
+ runRemote(command: string, options?: PlacementCommandOptions): import("./placement-host.ts").PlacementCommandResult;
42
+ replaceConnection(input: {
43
+ connection: C;
44
+ unsubscribe: () => void;
45
+ paneId: string;
46
+ state: HerdrRunSnapshot["state"];
47
+ }): Promise<void>;
48
+ cleanup(closeStartedPane?: boolean): Promise<void>;
49
+ }
@@ -0,0 +1,93 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import { getAgentDir } from "../../shared/utils.js";
4
+ /** Prints `$1/manifest.json` when it is a regular file, never through a symlink. */
5
+ export const PLACED_MANIFEST_READ_SCRIPT = 'p="$1/manifest.json"; test -f "$p" && test ! -L "$p" && cat "$p"';
6
+ export async function discoverPlacedBridgeManifest(access, runId, runtimeDir, missing = "The placed Pi's pi-subagents bridge manifest is not in its runtime directory; the Pi may have exited.") {
7
+ for (let attempt = 0; attempt < 100; attempt++) {
8
+ const result = await access.runAsync(access.shellCommand(PLACED_MANIFEST_READ_SCRIPT, [runtimeDir]), { timeout: 5_000, maxBuffer: 64 * 1024 });
9
+ if (result.error)
10
+ throw new Error(`Remote bridge manifest discovery failed: ${result.error.message}`, { cause: result.error });
11
+ if (result.status === 0 && result.stdout.trim()) {
12
+ let value;
13
+ try {
14
+ value = JSON.parse(result.stdout);
15
+ }
16
+ catch {
17
+ throw new Error("Remote bridge manifest is malformed.");
18
+ }
19
+ const p = value;
20
+ if (p.runId !== runId || typeof p.socketPath !== "string" || path.posix.dirname(p.socketPath) !== runtimeDir || typeof p.nativeSessionId !== "string" || typeof p.packageVersion !== "string" || typeof p.protocol !== "number")
21
+ throw new Error("Remote bridge manifest identity is incomplete or outside its owned runtime directory.");
22
+ return { socketPath: p.socketPath, nativeSessionId: p.nativeSessionId, packageVersion: p.packageVersion, protocol: p.protocol };
23
+ }
24
+ await new Promise((resolve) => setTimeout(resolve, 50));
25
+ }
26
+ throw new Error(missing);
27
+ }
28
+ export async function createPlacedRuntimeDir(access, runId) { const result = await access.runAsync(access.shellCommand("umask 077; mktemp -d \"${TMPDIR:-/tmp}/pi-subagents-herdr-$1-XXXXXXXX\"", [runId]), { timeout: 10_000, maxBuffer: 4096 }); if (result.error)
29
+ throw new Error(`Could not provision a run-private remote bridge runtime directory: ${result.error.message}`, { cause: result.error }); const value = result.stdout.trim(); if (result.status !== 0 || !path.posix.isAbsolute(value) || value.includes("\n"))
30
+ throw new Error("Could not provision a run-private remote bridge runtime directory."); return value; }
31
+ export function removePlacedRuntimeDir(access, runtimeDir) { const result = access.run(access.shellCommand("p=$1; case \"${p##*/}\" in pi-subagents-herdr-*) test -d \"$p\" && test ! -L \"$p\" && rm -rf -- \"$p\";; *) exit 64;; esac", [runtimeDir]), { timeout: 10_000, maxBuffer: 4096 }); if (result.status !== 0 || result.stdout)
32
+ throw new Error(`Could not remove the exact owned remote runtime directory: ${String(result.stderr).slice(0, 512)}`); }
33
+ /** The single private owner for allocation shared by every pane-native backend projection. */
34
+ export class PlacedRunOwner {
35
+ machine;
36
+ runId;
37
+ runtimeDir;
38
+ connection;
39
+ host;
40
+ access;
41
+ owned;
42
+ terminalId;
43
+ agentName;
44
+ startedArgv;
45
+ identity;
46
+ #unsubscribe = () => { };
47
+ #snapshot = { connection: "connected", state: "ready", revision: 0 };
48
+ #cleanupPromise;
49
+ #removeRuntime;
50
+ constructor(machine, runId, runtimeDir, connection, host, access, removeRuntime = () => removePlacedRuntimeDir(access, runtimeDir)) { this.machine = machine; this.runId = runId; this.runtimeDir = runtimeDir; this.connection = connection; this.#removeRuntime = removeRuntime; this.host = host; this.access = access; }
51
+ observeEvent(event) { const data = this.host.paneEvent(event, this.#snapshot.state); if (data && (!this.terminalId || data.terminalId === this.terminalId || data.paneId === this.owned?.paneId))
52
+ this.#snapshot = { ...this.#snapshot, revision: this.#snapshot.revision + 1, state: data.state }; }
53
+ markConnectionUnknown(observed) { if (this.connection !== observed)
54
+ return false; this.#snapshot = { ...this.#snapshot, connection: "unknown", state: "unknown", revision: this.#snapshot.revision + 1 }; return true; }
55
+ async subscribe(listener, disconnected) { const observed = this.connection, paneId = this.owned?.paneId; let adopted = false, candidateLost; if (!paneId)
56
+ throw new Error("Herdr status subscription requires a provisioned pane."); const unsubscribe = await this.host.subscribe(observed, paneId, (event) => { this.observeEvent(event); listener(event); }, (error) => { if (!adopted) {
57
+ candidateLost ??= error;
58
+ return;
59
+ } if (!this.markConnectionUnknown(observed))
60
+ return; disconnected(error); }); if (candidateLost) {
61
+ unsubscribe();
62
+ throw candidateLost;
63
+ } this.#unsubscribe = unsubscribe; adopted = true; }
64
+ /** Create the owned pane and start the agent in one host step; onPane runs once the pane exists and before the agent starts. */
65
+ async launch(request, onPane, options = {}) {
66
+ const { owned, terminalId } = await this.host.launch(this.connection, this.machine, this.runId, this.runtimeDir, request, async (pane) => { this.owned = pane; await onPane(pane); }, options), argv = [request.kind, ...request.args];
67
+ this.agentName = request.name;
68
+ this.terminalId = terminalId;
69
+ this.startedArgv = argv;
70
+ return { owned, terminalId, argv };
71
+ }
72
+ journal(identity) { this.identity = identity; this.#snapshot = { ...this.#snapshot, identity }; const journalDir = path.join(getAgentDir(), "pi-subagents", "herdr-run-journal"); fs.mkdirSync(journalDir, { recursive: true, mode: 0o700 }); fs.writeFileSync(path.join(journalDir, `${this.runId}.json`), JSON.stringify({ version: 1, identity, state: "ready", updatedAt: Date.now() }), { mode: 0o600, flag: "wx" }); }
73
+ get snapshot() { return this.#snapshot; }
74
+ runRemote(command, options = {}) { return this.access.run(command, options); }
75
+ async replaceConnection(input) { const oldConnection = this.connection, oldUnsubscribe = this.#unsubscribe; this.connection = input.connection; this.#unsubscribe = input.unsubscribe; if (this.identity)
76
+ this.identity = { ...this.identity, paneId: input.paneId }; this.#snapshot = { connection: "connected", state: input.state, identity: this.identity, revision: this.#snapshot.revision + 1 }; oldUnsubscribe(); await oldConnection.close(); }
77
+ cleanup(closeStartedPane = true) { return this.#cleanupPromise ??= this.#performCleanup(closeStartedPane); }
78
+ async #performCleanup(closeStartedPane) { let failure; try {
79
+ if (closeStartedPane && this.owned)
80
+ await this.host.closeOwnedPane(this.connection, this.owned, this.terminalId, this.agentName);
81
+ }
82
+ catch (error) {
83
+ failure = error;
84
+ } try {
85
+ this.#unsubscribe();
86
+ await this.connection.close();
87
+ this.#removeRuntime();
88
+ }
89
+ catch (error) {
90
+ failure ??= error;
91
+ } this.#snapshot = { ...this.#snapshot, connection: "closed", revision: this.#snapshot.revision + 1 }; if (failure)
92
+ throw failure; }
93
+ }
@@ -0,0 +1,99 @@
1
+ import type { PlacementMachineReference } from "../../shared/types.ts";
2
+ import type { HerdrRunIdentity } from "./herdr-placed-run.ts";
3
+ export type PlacementRunState = "ready" | "working" | "blocked" | "settled" | "unknown";
4
+ export type PlacementAgentKind = "pi" | "claude" | "cursor" | "codex";
5
+ export interface PlacementOwnedPane {
6
+ workspaceId: string;
7
+ tabId: string;
8
+ paneId: string;
9
+ }
10
+ export interface PlacementBridgeIdentity {
11
+ runId?: string;
12
+ nativeSessionId?: string;
13
+ packageVersion?: string;
14
+ protocol?: number;
15
+ evidenceCursor?: number;
16
+ evidenceFloor?: number;
17
+ }
18
+ export type PlacementEvidenceProof = {
19
+ ok: true;
20
+ cursor: number;
21
+ } | {
22
+ ok: false;
23
+ reason: string;
24
+ };
25
+ export type PlacementReconnectCheck = {
26
+ ok: true;
27
+ state: PlacementRunState;
28
+ paneId: string;
29
+ cursor: number;
30
+ } | {
31
+ ok: false;
32
+ reason: string;
33
+ };
34
+ export interface PlacementStartOptions {
35
+ timeoutMs?: number;
36
+ pollMs?: number;
37
+ clock?: {
38
+ now(): number;
39
+ wait(ms: number): Promise<void>;
40
+ };
41
+ }
42
+ /** What to start in a new pane; the pane is created in the machine's cwd with this environment. */
43
+ export interface PlacementLaunchRequest {
44
+ kind: PlacementAgentKind;
45
+ name: string;
46
+ args: string[];
47
+ environment?: Record<string, string>;
48
+ }
49
+ export interface PlacementCommandOptions {
50
+ timeout?: number;
51
+ maxBuffer?: number;
52
+ }
53
+ export interface PlacementCommandResult {
54
+ status: number | null;
55
+ stdout: string;
56
+ stderr: string;
57
+ error?: Error;
58
+ }
59
+ export interface PlacementSocketForward {
60
+ socketPath: string;
61
+ close(): Promise<void>;
62
+ }
63
+ /** Unix sockets on the pane machine made reachable from the parent; close() ends every forward opened through it. */
64
+ export interface PlacementSockets {
65
+ forwardRemoteSocket(remotePath: string, name: string): Promise<PlacementSocketForward>;
66
+ close(): Promise<void>;
67
+ }
68
+ /** Runs commands on, and reaches unix sockets on, the machine that hosts the pane: over SSH (`sshMachineAccess`) or directly (`localMachineAccess`). */
69
+ export interface PlacementMachineAccess {
70
+ shellCommand(script: string, args?: string[]): string;
71
+ run(command: string, options?: PlacementCommandOptions): PlacementCommandResult;
72
+ runAsync(command: string, options?: PlacementCommandOptions): Promise<PlacementCommandResult>;
73
+ openSockets(): PlacementSockets;
74
+ }
75
+ /** Every pane operation a placed native run and its owner need. The connection carries the host's socket forwarding; P is the host's reconnect view of its panes. */
76
+ export interface PlacementPaneHost<C extends PlacementSockets = PlacementSockets, P extends object = object> {
77
+ connect(machine: PlacementMachineReference): Promise<C>;
78
+ sessionOf(connection: C): string | null;
79
+ /** Create the pane and start the agent in it; call onPane after the pane exists and before the agent starts. */
80
+ launch(connection: C, machine: PlacementMachineReference, runId: string, runtimeDir: string, request: PlacementLaunchRequest, onPane: (owned: PlacementOwnedPane) => Promise<void>, options?: PlacementStartOptions): Promise<{
81
+ owned: PlacementOwnedPane;
82
+ terminalId: string;
83
+ }>;
84
+ prompt(connection: C, identity: HerdrRunIdentity, text: string): Promise<void>;
85
+ subscribe(connection: C, paneId: string, listener: (event: unknown) => void, onDisconnect: (error: Error) => void): Promise<() => void>;
86
+ paneEvent(event: unknown, fallback: PlacementRunState): {
87
+ terminalId: unknown;
88
+ paneId: unknown;
89
+ state: PlacementRunState;
90
+ } | undefined;
91
+ panes(connection: C, identity: HerdrRunIdentity): Promise<P>;
92
+ reconcile(identity: HerdrRunIdentity, panes: P, proveEvidence: () => PlacementEvidenceProof): PlacementReconnectCheck;
93
+ closeOwnedPane(connection: C, owned: PlacementOwnedPane, terminalId: string | undefined, agentName: string | undefined): Promise<void>;
94
+ }
95
+ export declare function herdrPaneAllocationKey(target: string, session: string | null, cwd: string): string;
96
+ export declare function withHerdrPaneAllocationLock<T>(key: string, action: () => Promise<T>, options?: {
97
+ timeoutMs?: number;
98
+ pollMs?: number;
99
+ }): Promise<T>;
@@ -0,0 +1,157 @@
1
+ import { createHash, randomBytes } from "node:crypto";
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import { getAgentDir } from "../../shared/utils.js";
5
+ const HERDR_ALLOCATION_LOCK_TIMEOUT_MS = 10_000, HERDR_ALLOCATION_LOCK_POLL_MS = 25;
6
+ export function herdrPaneAllocationKey(target, session, cwd) { return JSON.stringify([target, session, cwd]); }
7
+ function assertPrivateDir(directory) { const stat = fs.lstatSync(directory); if (!stat.isDirectory() || stat.isSymbolicLink() || (stat.mode & 0o777) !== 0o700 || (typeof process.getuid === "function" && stat.uid !== process.getuid()))
8
+ throw new Error("Herdr allocation path is not a mode-0700 agent-private owned directory."); }
9
+ function ensurePrivateChild(parent, name) { const directory = path.join(parent, name); try {
10
+ fs.mkdirSync(directory, { mode: 0o700 });
11
+ }
12
+ catch (error) {
13
+ if (error.code !== "EEXIST")
14
+ throw error;
15
+ } assertPrivateDir(directory); return directory; }
16
+ function allocationLockRoot() { const agentDir = getAgentDir(); fs.mkdirSync(agentDir, { recursive: true, mode: 0o700 }); assertPrivateDir(agentDir); const packageDir = ensurePrivateChild(agentDir, "pi-subagents"); return ensurePrivateChild(packageDir, "herdr-allocation-locks"); }
17
+ function livePid(pid) { try {
18
+ process.kill(pid, 0);
19
+ return true;
20
+ }
21
+ catch (error) {
22
+ return error.code === "EPERM";
23
+ } }
24
+ function readAllocationOwner(ownerPath) { const descriptor = fs.openSync(ownerPath, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0)); try {
25
+ const stat = fs.fstatSync(descriptor);
26
+ if (!stat.isFile() || (stat.mode & 0o777) !== 0o600 || (typeof process.getuid === "function" && stat.uid !== process.getuid()))
27
+ throw new Error("Herdr allocation lock owner record is unsafe.");
28
+ const value = JSON.parse(fs.readFileSync(descriptor, "utf8"));
29
+ if (typeof value.pid !== "number" || !Number.isSafeInteger(value.pid) || value.pid <= 0 || typeof value.token !== "string" || !/^[a-f0-9]{32}$/u.test(value.token))
30
+ throw new Error("Herdr allocation lock owner record is malformed.");
31
+ return { pid: value.pid, token: value.token, dev: stat.dev, ino: stat.ino };
32
+ }
33
+ finally {
34
+ fs.closeSync(descriptor);
35
+ } }
36
+ function sameOwner(left, right) { return left.token === right.token && left.dev === right.dev && left.ino === right.ino; }
37
+ export async function withHerdrPaneAllocationLock(key, action, options = {}) {
38
+ const root = allocationLockRoot(), digest = createHash("sha256").update(key).digest("hex"), lockPath = path.join(root, `${digest}.lock`), recoveryPath = path.join(root, `${digest}.recovery`), token = randomBytes(16).toString("hex"), tempPath = path.join(root, `.${digest}.${token}.tmp`), deadline = Date.now() + (options.timeoutMs ?? HERDR_ALLOCATION_LOCK_TIMEOUT_MS);
39
+ let published;
40
+ try {
41
+ fs.writeFileSync(tempPath, JSON.stringify({ pid: process.pid, token, createdAt: Date.now() }), { mode: 0o600, flag: "wx" });
42
+ const tempOwner = readAllocationOwner(tempPath);
43
+ for (;;) {
44
+ let recovering = false;
45
+ try {
46
+ readAllocationOwner(recoveryPath);
47
+ recovering = true;
48
+ }
49
+ catch (error) {
50
+ if (error.code !== "ENOENT")
51
+ throw error;
52
+ }
53
+ if (!recovering) {
54
+ let linked = false;
55
+ try {
56
+ fs.linkSync(tempPath, lockPath);
57
+ linked = true;
58
+ try {
59
+ readAllocationOwner(recoveryPath);
60
+ const current = readAllocationOwner(lockPath);
61
+ if (!sameOwner(current, tempOwner))
62
+ throw new Error("Herdr allocation lock changed during publication.");
63
+ fs.unlinkSync(lockPath);
64
+ }
65
+ catch (recoveryError) {
66
+ if (recoveryError.code !== "ENOENT")
67
+ throw recoveryError;
68
+ published = readAllocationOwner(lockPath);
69
+ if (!sameOwner(published, tempOwner))
70
+ throw new Error("Herdr allocation lock publication identity changed.");
71
+ break;
72
+ }
73
+ }
74
+ catch (publishError) {
75
+ if (linked) {
76
+ try {
77
+ const current = readAllocationOwner(lockPath);
78
+ if (sameOwner(current, tempOwner))
79
+ fs.unlinkSync(lockPath);
80
+ }
81
+ catch { }
82
+ }
83
+ if (publishError.code !== "EEXIST" && publishError.code !== "ENOENT")
84
+ throw publishError;
85
+ }
86
+ }
87
+ if (published)
88
+ break;
89
+ try {
90
+ const current = readAllocationOwner(lockPath);
91
+ if (!livePid(current.pid)) {
92
+ let claimed = false;
93
+ try {
94
+ fs.linkSync(lockPath, recoveryPath);
95
+ claimed = true;
96
+ const recovery = readAllocationOwner(recoveryPath), latest = readAllocationOwner(lockPath);
97
+ if (!sameOwner(recovery, current) || !sameOwner(latest, current))
98
+ throw new Error("Herdr stale lock identity changed during recovery.");
99
+ fs.unlinkSync(lockPath);
100
+ }
101
+ catch (error) {
102
+ if (error.code !== "EEXIST" && error.code !== "ENOENT")
103
+ throw error;
104
+ }
105
+ finally {
106
+ if (claimed)
107
+ fs.unlinkSync(recoveryPath);
108
+ }
109
+ if (claimed)
110
+ continue;
111
+ }
112
+ }
113
+ catch (error) {
114
+ if (error.code !== "ENOENT")
115
+ throw error;
116
+ }
117
+ if (Date.now() >= deadline)
118
+ throw new Error("Timed out waiting for the Herdr pane allocation lock.");
119
+ await new Promise((resolve) => setTimeout(resolve, options.pollMs ?? HERDR_ALLOCATION_LOCK_POLL_MS));
120
+ }
121
+ fs.unlinkSync(tempPath);
122
+ let value, actionError, releaseError, actionFailed = false, releaseFailed = false;
123
+ try {
124
+ value = await action();
125
+ }
126
+ catch (error) {
127
+ actionFailed = true;
128
+ actionError = error;
129
+ }
130
+ try {
131
+ const current = readAllocationOwner(lockPath);
132
+ if (!published || !sameOwner(current, published))
133
+ throw new Error("Herdr pane allocation lock ownership changed before release.");
134
+ fs.unlinkSync(lockPath);
135
+ }
136
+ catch (error) {
137
+ releaseFailed = true;
138
+ releaseError = error;
139
+ }
140
+ if (actionFailed && releaseFailed)
141
+ throw new AggregateError([actionError, releaseError], "Herdr pane allocation action and release both failed.", { cause: actionError });
142
+ if (actionFailed)
143
+ throw actionError;
144
+ if (releaseFailed)
145
+ throw releaseError;
146
+ return value;
147
+ }
148
+ finally {
149
+ try {
150
+ fs.unlinkSync(tempPath);
151
+ }
152
+ catch (error) {
153
+ if (error.code !== "ENOENT")
154
+ throw error;
155
+ }
156
+ }
157
+ }
@@ -0,0 +1,15 @@
1
+ export declare function formatProcessSignalError(signal: string): string;
2
+ export declare function formatMidToolExitError(input: {
3
+ toolName: string;
4
+ exitCode?: number | null;
5
+ processSignal?: string | null;
6
+ }): string;
7
+ export declare function isOrdinaryToolForMidToolExit(toolName: string): boolean;
8
+ export declare function isUnexplainedProcessSignal(input: {
9
+ processSignal?: string | null;
10
+ interrupted?: boolean;
11
+ timedOut?: boolean;
12
+ stopped?: boolean;
13
+ turnBudgetExceeded?: boolean;
14
+ forcedDrainAfterFinalSuccess?: boolean;
15
+ }): boolean;
@@ -0,0 +1,21 @@
1
+ export function formatProcessSignalError(signal) {
2
+ return `Subagent process terminated by signal ${signal}.`;
3
+ }
4
+ export function formatMidToolExitError(input) {
5
+ if (input.exitCode === undefined && !input.processSignal) {
6
+ return `Subagent session ended during '${input.toolName}' tool execution before the tool completed. Earlier assistant output is not a terminal result.`;
7
+ }
8
+ const terminal = [`exit ${input.exitCode ?? "unknown"}`, ...(input.processSignal ? [`signal ${input.processSignal}`] : [])].join(", ");
9
+ return `Subagent process exited during '${input.toolName}' tool execution (${terminal}) before the tool completed. Earlier assistant output is not a terminal result.`;
10
+ }
11
+ export function isOrdinaryToolForMidToolExit(toolName) {
12
+ return toolName !== "intercom" && toolName !== "contact_supervisor";
13
+ }
14
+ export function isUnexplainedProcessSignal(input) {
15
+ return Boolean(input.processSignal)
16
+ && input.interrupted !== true
17
+ && input.timedOut !== true
18
+ && input.stopped !== true
19
+ && input.turnBudgetExceeded !== true
20
+ && input.forcedDrainAfterFinalSuccess !== true;
21
+ }
@@ -0,0 +1,21 @@
1
+ import type { ResolvedSubagentCapabilityCeiling } from "./capability-ceiling.ts";
2
+ export declare function resolveSandboxExtensionForProfile(profileName: string): string;
3
+ export interface ResolvedProfileExtensions {
4
+ /** Absolute path of the resolved pi-sandbox child extension when a sandbox profile is selected. */
5
+ sandboxExtension?: string;
6
+ /** The permission-system child extension a launch must load: rules-driven or profile-driven. */
7
+ effectivePermSystemExt?: string;
8
+ }
9
+ /**
10
+ * Validate the selected sandbox/permission profiles and resolve the child
11
+ * extensions they require. `permSystemExt` is the rules-driven permission-system
12
+ * resolution the tool plan already computed; when only a permission profile is
13
+ * selected the extension is resolved eagerly here and a missing package fails
14
+ * the launch instead of silently degrading to no policy at all.
15
+ */
16
+ export declare function resolveProfileExtensions(input: {
17
+ sandbox?: string;
18
+ permissionProfile?: string;
19
+ capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
20
+ permSystemExt?: string;
21
+ }): ResolvedProfileExtensions;