@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,1321 @@
1
+ import {
2
+ snapshotRequiredChildExtensions
3
+ } from "./chunk-CTPAE36Y.js";
4
+ import {
5
+ THINKING_LEVELS,
6
+ findConfiguredProjectRoot,
7
+ getAgentDir,
8
+ getConfigDirName,
9
+ getProjectConfigDir,
10
+ validatePermissionProfileName,
11
+ validateSandboxProfileName
12
+ } from "./chunk-V2KFIGFH.js";
13
+ import {
14
+ TEMP_ROOT_DIR
15
+ } from "./chunk-UQDHXMUG.js";
16
+ import {
17
+ capabilityCeilingAgentRestrictionSources,
18
+ intersectSubagentCapabilityCeilings,
19
+ isAgentAllowedByCapabilityCeiling
20
+ } from "./chunk-QXASAHIA.js";
21
+
22
+ // src/runs/shared/child-tool-plan.ts
23
+ import { createHash as createHash2 } from "node:crypto";
24
+ import * as fs5 from "node:fs";
25
+ import * as path5 from "node:path";
26
+ import { fileURLToPath } from "node:url";
27
+
28
+ // src/runs/shared/mcp-direct-tool-allowlist.ts
29
+ import { createHash } from "node:crypto";
30
+ import * as fs2 from "node:fs";
31
+ import * as os2 from "node:os";
32
+ import * as path2 from "node:path";
33
+
34
+ // src/runs/shared/mcp-config-sources.ts
35
+ import * as fs from "node:fs";
36
+ import * as os from "node:os";
37
+ import * as path from "node:path";
38
+ var PACKAGE_CONFIG_ROOT = "npm";
39
+ var PACKAGE_GIT_ROOT = "git";
40
+ var PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
41
+ var PLUGIN_MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
42
+ var PLUGIN_NAME_PATTERN = /^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/;
43
+ var PLUGIN_STDIO_FIELDS = /* @__PURE__ */ new Set(["type", "command", "args", "env", "cwd"]);
44
+ var PLUGIN_HTTP_FIELDS = /* @__PURE__ */ new Set(["type", "url", "headers"]);
45
+ function isMcpServerDefinition(value) {
46
+ if (!isRecord(value)) return false;
47
+ for (const field of ["command", "socket", "cwd", "url", "bearerToken", "bearerTokenEnv", "protocolVersion", "httpTransport", "pluginDataDir"]) {
48
+ if (value[field] !== void 0 && typeof value[field] !== "string") return false;
49
+ }
50
+ for (const field of ["args", "includeTools", "excludeTools"]) {
51
+ if (value[field] !== void 0 && !isStringArray(value[field])) return false;
52
+ }
53
+ for (const field of ["env", "headers"]) {
54
+ if (value[field] !== void 0 && !isStringRecord(value[field])) return false;
55
+ }
56
+ for (const field of ["exposeResources", "literalEnv", "inheritEnv"]) {
57
+ if (value[field] !== void 0 && typeof value[field] !== "boolean") return false;
58
+ }
59
+ if (value.requestHeadersCommand !== void 0 && !isRequestHeadersCommand(value.requestHeadersCommand)) return false;
60
+ if (value.auth !== void 0 && value.auth !== "oauth" && value.auth !== "bearer" && value.auth !== false) return false;
61
+ return value.directTools === void 0 || typeof value.directTools === "boolean" || isStringArray(value.directTools);
62
+ }
63
+ function isRecord(value) {
64
+ return value !== null && typeof value === "object" && !Array.isArray(value);
65
+ }
66
+ function isStringArray(value) {
67
+ return Array.isArray(value) && value.every((entry) => typeof entry === "string");
68
+ }
69
+ function isStringRecord(value) {
70
+ return isRecord(value) && Object.values(value).every((entry) => typeof entry === "string");
71
+ }
72
+ function isRequestHeadersCommand(value) {
73
+ if (!isRecord(value) || typeof value.command !== "string") return false;
74
+ if (value.args !== void 0 && !isStringArray(value.args)) return false;
75
+ if (value.env !== void 0 && !isStringRecord(value.env)) return false;
76
+ return value.timeoutMs === void 0 || typeof value.timeoutMs === "number" && Number.isFinite(value.timeoutMs);
77
+ }
78
+ function loadPackageMcpServers(cwd) {
79
+ const servers = {};
80
+ const seen = /* @__PURE__ */ new Set();
81
+ for (const packageRoot of getConfiguredPackageRoots(cwd)) {
82
+ const manifest = readJson(path.join(packageRoot, "package.json"));
83
+ if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) continue;
84
+ const packageName = manifest.name;
85
+ if (typeof packageName !== "string" || !packageName) continue;
86
+ const mcpValue = manifest.pi?.mcp;
87
+ const configPaths = typeof mcpValue === "string" ? [mcpValue] : Array.isArray(mcpValue) && mcpValue.every((value) => typeof value === "string") ? mcpValue : [];
88
+ const packagePrefix = formatName(packageName, "package");
89
+ for (const configPath of configPaths) {
90
+ const resolvedPath = resolvePackageConfigPath(packageRoot, configPath);
91
+ if (!resolvedPath) continue;
92
+ const config = readJson(resolvedPath);
93
+ if (!config || typeof config !== "object" || Array.isArray(config)) continue;
94
+ const rawServers = config.mcpServers;
95
+ if (!rawServers || typeof rawServers !== "object" || Array.isArray(rawServers)) continue;
96
+ for (const [serverName, definition] of Object.entries(rawServers)) {
97
+ if (!isMcpServerDefinition(definition)) continue;
98
+ const normalizedName = `${packagePrefix}__${formatName(serverName, "server")}`;
99
+ if (seen.has(normalizedName)) continue;
100
+ seen.add(normalizedName);
101
+ servers[normalizedName] = definition;
102
+ }
103
+ }
104
+ }
105
+ return servers;
106
+ }
107
+ function loadAgentPluginMcpServers(paths, cwd) {
108
+ const servers = {};
109
+ if (!Array.isArray(paths)) return servers;
110
+ for (const configuredPath of paths) {
111
+ if (typeof configuredPath !== "string") continue;
112
+ const pluginRoot = resolvePluginPath(configuredPath, cwd);
113
+ const manifest = readJson(path.join(pluginRoot, "plugin.json"));
114
+ if (!isValidPluginManifest(manifest)) continue;
115
+ const config = readJson(path.join(pluginRoot, "mcp.json"));
116
+ if (!isValidPluginConfig(config)) continue;
117
+ const rawServers = config.mcpServers;
118
+ for (const [serverName, rawDefinition] of Object.entries(rawServers)) {
119
+ const definition = translatePluginServer(manifest.name, pluginRoot, rawDefinition);
120
+ if (!definition) continue;
121
+ const normalizedName = `${formatName(manifest.name, "plugin")}__${formatName(serverName, "server")}`;
122
+ if (Object.hasOwn(servers, normalizedName)) continue;
123
+ servers[normalizedName] = definition;
124
+ }
125
+ }
126
+ return servers;
127
+ }
128
+ function getConfiguredPackageRoots(cwd) {
129
+ const roots = [];
130
+ const projectConfigDir = findProjectConfigDir(cwd);
131
+ const sources = [
132
+ { path: path.join(projectConfigDir, "settings.json"), baseDir: projectConfigDir },
133
+ { path: path.join(getAgentDir(), "settings.json"), baseDir: getAgentDir() }
134
+ ];
135
+ for (const source of sources) {
136
+ const settings = readJson(source.path);
137
+ if (!settings || typeof settings !== "object" || Array.isArray(settings)) continue;
138
+ const packages = settings.packages;
139
+ if (!Array.isArray(packages)) continue;
140
+ for (const entry of packages) {
141
+ const packageSource = typeof entry === "string" ? entry : entry && typeof entry === "object" && !Array.isArray(entry) && typeof entry.source === "string" ? entry.source : void 0;
142
+ if (!packageSource) continue;
143
+ const root = resolvePackageRoot(packageSource, source.baseDir);
144
+ if (root && !roots.includes(root)) roots.push(root);
145
+ }
146
+ }
147
+ return roots;
148
+ }
149
+ function findProjectConfigDir(cwd) {
150
+ const projectRoot = findConfiguredProjectRoot(path.resolve(cwd));
151
+ return projectRoot ? getProjectConfigDir(projectRoot) : path.join(path.resolve(cwd), getConfigDirName());
152
+ }
153
+ function resolvePackageRoot(source, baseDir) {
154
+ const trimmed = source.trim();
155
+ if (!trimmed) return void 0;
156
+ if (trimmed.startsWith("npm:")) {
157
+ const packageName = parseNpmPackageName(trimmed);
158
+ return packageName ? resolveContainedPath(path.join(baseDir, PACKAGE_CONFIG_ROOT, "node_modules"), packageName) ?? void 0 : void 0;
159
+ }
160
+ if (trimmed.startsWith("git:") || /^(?:https?:\/\/|ssh:\/\/|git@[^:]+:)/.test(trimmed)) {
161
+ const parsed = parseGitPackagePath(trimmed.startsWith("git:") ? trimmed : `git:${trimmed}`);
162
+ return parsed ? path.join(baseDir, PACKAGE_GIT_ROOT, parsed.host, parsed.repoPath) : void 0;
163
+ }
164
+ const localPath = trimmed.startsWith("file:") ? trimmed.slice(5) : trimmed;
165
+ if (localPath === "~") return os.homedir();
166
+ if (localPath.startsWith("~/")) return path.join(os.homedir(), localPath.slice(2));
167
+ return path.isAbsolute(localPath) ? path.resolve(localPath) : path.resolve(baseDir, localPath);
168
+ }
169
+ function parseNpmPackageName(source) {
170
+ const spec = source.slice(4).trim();
171
+ if (!spec) return void 0;
172
+ const match = spec.match(/^(@?[^@]+(?:\/[^@]+)?)(?:@(.+))?$/);
173
+ const packageName = match?.[1] ?? spec;
174
+ return resolveContainedPath("/", packageName) ? packageName : void 0;
175
+ }
176
+ function parseGitPackagePath(source) {
177
+ const spec = source.slice(4).trim();
178
+ if (!spec) return void 0;
179
+ let host = "";
180
+ let repoPath = "";
181
+ const scpLike = spec.match(/^git@([^:]+):(.+)$/);
182
+ if (scpLike) {
183
+ host = scpLike[1] ?? "";
184
+ repoPath = scpLike[2] ?? "";
185
+ } else if (/^[a-z][a-z0-9+.-]*:\/\//i.test(spec)) {
186
+ try {
187
+ const url = new URL(spec);
188
+ host = url.hostname;
189
+ repoPath = url.pathname.replace(/^\/+/, "");
190
+ } catch {
191
+ return void 0;
192
+ }
193
+ } else {
194
+ const slashIndex = spec.indexOf("/");
195
+ if (slashIndex < 0) return void 0;
196
+ host = spec.slice(0, slashIndex);
197
+ repoPath = spec.slice(slashIndex + 1);
198
+ }
199
+ const normalizedPath = stripGitRef(repoPath).replace(/\.git$/, "").replace(/^\/+/, "");
200
+ if (!host || !isSafePackagePath(host) || !isSafePackagePath(normalizedPath) || normalizedPath.split(/[\\/]/).length < 2) {
201
+ return void 0;
202
+ }
203
+ return { host, repoPath: normalizedPath };
204
+ }
205
+ function stripGitRef(repoPath) {
206
+ const atIndex = repoPath.indexOf("@");
207
+ const hashIndex = repoPath.indexOf("#");
208
+ const refIndex = [atIndex, hashIndex].filter((index) => index >= 0).sort((a, b) => a - b)[0];
209
+ return refIndex === void 0 ? repoPath : repoPath.slice(0, refIndex);
210
+ }
211
+ function isSafePackagePath(value) {
212
+ return value.length > 0 && !path.isAbsolute(value) && value.split(/[\\/]/).every((part) => part.length > 0 && part !== "." && part !== "..");
213
+ }
214
+ function resolvePackageConfigPath(packageRoot, configuredPath) {
215
+ const lexicalPath = resolveContainedPath(packageRoot, configuredPath);
216
+ if (!lexicalPath || !fs.existsSync(lexicalPath)) return void 0;
217
+ try {
218
+ if (!fs.statSync(lexicalPath).isFile()) return void 0;
219
+ const packageRealPath = fs.realpathSync(packageRoot);
220
+ const configRealPath = fs.realpathSync(lexicalPath);
221
+ return resolveContainedPath(packageRealPath, configRealPath) ?? void 0;
222
+ } catch {
223
+ return void 0;
224
+ }
225
+ }
226
+ function resolveContainedPath(root, value) {
227
+ const resolved = path.resolve(root, value);
228
+ const relative3 = path.relative(root, resolved);
229
+ return relative3 === "" || !relative3.startsWith("..") && !relative3.startsWith(path.sep) && !path.isAbsolute(relative3) ? resolved : void 0;
230
+ }
231
+ function resolvePluginPath(configuredPath, cwd) {
232
+ if (configuredPath === "~") return path.resolve(process.env.HOME ?? "", ".");
233
+ if (configuredPath.startsWith("~/")) return path.resolve(process.env.HOME ?? "", configuredPath.slice(2));
234
+ return path.isAbsolute(configuredPath) ? path.resolve(configuredPath) : path.resolve(cwd, configuredPath);
235
+ }
236
+ function isValidPluginManifest(value) {
237
+ if (!value || typeof value !== "object" || Array.isArray(value)) return false;
238
+ const manifest = value;
239
+ return manifest.$schema === PLUGIN_SCHEMA && typeof manifest.name === "string" && manifest.name.length >= 1 && manifest.name.length <= 64 && PLUGIN_NAME_PATTERN.test(manifest.name);
240
+ }
241
+ function isValidPluginConfig(value) {
242
+ if (!value || typeof value !== "object" || Array.isArray(value)) return false;
243
+ const config = value;
244
+ return config.$schema === PLUGIN_MCP_SCHEMA && Object.keys(config).every((key) => key === "$schema" || key === "mcpServers") && !!config.mcpServers && typeof config.mcpServers === "object" && !Array.isArray(config.mcpServers);
245
+ }
246
+ function translatePluginServer(pluginName, pluginRoot, value) {
247
+ if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
248
+ const raw = value;
249
+ if (raw.type === "stdio") return translatePluginStdioServer(pluginName, pluginRoot, raw);
250
+ if (raw.type === "streamable-http" || raw.type === "sse") return translatePluginHttpServer(raw);
251
+ return void 0;
252
+ }
253
+ function translatePluginStdioServer(pluginName, pluginRoot, raw) {
254
+ if ([...Object.keys(raw)].some((key) => !PLUGIN_STDIO_FIELDS.has(key))) return void 0;
255
+ if (typeof raw.command !== "string" || !raw.command) return void 0;
256
+ if (!isBareCommand(raw.command) && !raw.command.startsWith("./")) return void 0;
257
+ const args = stringArray(raw.args);
258
+ if (raw.args !== void 0 && !args) return void 0;
259
+ const env = stringRecord(raw.env);
260
+ if (raw.env !== void 0 && !env) return void 0;
261
+ if (env && (Object.hasOwn(env, "PLUGIN_ROOT") || Object.hasOwn(env, "PLUGIN_DATA"))) return void 0;
262
+ const pluginDataDir = path.join(getAgentDir(), "agent-plugin-data", pluginName);
263
+ const command = raw.command.startsWith("./") ? resolveContainedPath(pluginRoot, raw.command) : raw.command;
264
+ if (!command) return void 0;
265
+ const cwd = resolvePluginCwd(raw.cwd, pluginRoot, pluginDataDir);
266
+ if (!cwd) return void 0;
267
+ return {
268
+ command,
269
+ args: (args ?? []).map((value) => expandPluginPlaceholders(value, pluginRoot, pluginDataDir)),
270
+ env: {
271
+ ...Object.fromEntries(Object.entries(env ?? {}).map(([key, value]) => [key, expandPluginPlaceholders(value, pluginRoot, pluginDataDir)])),
272
+ PLUGIN_ROOT: pluginRoot,
273
+ PLUGIN_DATA: pluginDataDir
274
+ },
275
+ cwd,
276
+ pluginDataDir,
277
+ literalEnv: true
278
+ };
279
+ }
280
+ function translatePluginHttpServer(raw) {
281
+ if ([...Object.keys(raw)].some((key) => !PLUGIN_HTTP_FIELDS.has(key))) return void 0;
282
+ if (typeof raw.url !== "string" || !isValidPluginUrl(raw.url)) return void 0;
283
+ const headers = stringRecord(raw.headers);
284
+ if (raw.headers !== void 0 && !headers) return void 0;
285
+ if (headers) {
286
+ const normalized = /* @__PURE__ */ new Set();
287
+ for (const key of Object.keys(headers)) {
288
+ const lower = key.toLowerCase();
289
+ if (normalized.has(lower)) return void 0;
290
+ normalized.add(lower);
291
+ }
292
+ try {
293
+ new Headers(headers);
294
+ } catch {
295
+ return void 0;
296
+ }
297
+ }
298
+ return { url: raw.url, ...headers ? { headers } : {}, httpTransport: raw.type };
299
+ }
300
+ function resolvePluginCwd(value, pluginRoot, pluginDataDir) {
301
+ if (value === void 0) return pluginRoot;
302
+ if (typeof value !== "string") return void 0;
303
+ if (value.startsWith("./")) return resolveContainedPath(pluginRoot, value);
304
+ if (value === "${PLUGIN_ROOT}" || value.startsWith("${PLUGIN_ROOT}/")) return resolveContainedPath(pluginRoot, value.replace("${PLUGIN_ROOT}", "."));
305
+ if (value === "${PLUGIN_DATA}" || value.startsWith("${PLUGIN_DATA}/")) return resolveContainedPath(pluginDataDir, value.replace("${PLUGIN_DATA}", "."));
306
+ return void 0;
307
+ }
308
+ function expandPluginPlaceholders(value, pluginRoot, pluginDataDir) {
309
+ return value.replaceAll("${PLUGIN_ROOT}", pluginRoot).replaceAll("${PLUGIN_DATA}", pluginDataDir);
310
+ }
311
+ function isBareCommand(command) {
312
+ return !command.includes("/") && !command.includes("\\") && !command.includes("${PLUGIN_ROOT}") && !command.includes("${PLUGIN_DATA}");
313
+ }
314
+ function isValidPluginUrl(value) {
315
+ if (value.includes("${") || value.includes("$env:") || value.includes("{env:")) return false;
316
+ let url;
317
+ try {
318
+ url = new URL(value);
319
+ } catch {
320
+ return false;
321
+ }
322
+ if (url.protocol !== "http:" && url.protocol !== "https:") return false;
323
+ if (url.username || url.password || url.hash) return false;
324
+ if (url.protocol === "https:") return true;
325
+ const host = url.hostname.toLowerCase();
326
+ return host === "localhost" || host === "127.0.0.1" || host === "::1" || host === "[::1]" || /^127(?:\.\d{1,3}){3}$/.test(host);
327
+ }
328
+ function stringArray(value) {
329
+ return Array.isArray(value) && value.every((entry) => typeof entry === "string") ? value : void 0;
330
+ }
331
+ function stringRecord(value) {
332
+ if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
333
+ const entries = Object.entries(value);
334
+ if (entries.some(([, entry]) => typeof entry !== "string")) return void 0;
335
+ return Object.fromEntries(entries);
336
+ }
337
+ function formatName(value, fallback) {
338
+ return value.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || fallback;
339
+ }
340
+ function readJson(filePath) {
341
+ let content;
342
+ try {
343
+ content = fs.readFileSync(filePath, "utf-8");
344
+ } catch (error) {
345
+ if (error.code === "ENOENT") return void 0;
346
+ throw new Error(`Failed to read JSON file '${filePath}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
347
+ }
348
+ try {
349
+ return JSON.parse(content);
350
+ } catch (error) {
351
+ throw new Error(`Invalid JSON in '${filePath}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
352
+ }
353
+ }
354
+
355
+ // src/runs/shared/mcp-direct-tool-grant.ts
356
+ var BUILTIN_TOOL_NAMES = /* @__PURE__ */ new Set(["read", "bash", "edit", "write", "grep", "find", "ls", "mcp"]);
357
+ function normalizeMcpDirectToolSelectors(selectors) {
358
+ return [...new Set((selectors ?? []).map((selector) => selector.replace(/\/+$/, "")).filter(Boolean))];
359
+ }
360
+ function parseMcpDirectToolSelectors(selectors) {
361
+ const servers = /* @__PURE__ */ new Set();
362
+ const tools = /* @__PURE__ */ new Map();
363
+ for (const item of selectors) {
364
+ if (item.includes("/")) {
365
+ const [server, tool] = item.split("/", 2);
366
+ if (server && tool) {
367
+ if (!tools.has(server)) tools.set(server, /* @__PURE__ */ new Set());
368
+ tools.get(server).add(tool);
369
+ } else if (server) {
370
+ servers.add(server);
371
+ }
372
+ } else if (item) {
373
+ servers.add(item);
374
+ }
375
+ }
376
+ return { servers, tools };
377
+ }
378
+ function planMcpDirectToolGrant(input) {
379
+ const selectors = normalizeMcpDirectToolSelectors(input.selectors);
380
+ if (selectors.length === 0) return { selections: [], unresolvedSelectors: [] };
381
+ const { servers: selectedServers, tools: selectedTools } = parseMcpDirectToolSelectors(selectors);
382
+ const selections = [];
383
+ const seenNames = /* @__PURE__ */ new Set();
384
+ for (const [serverName, server] of Object.entries(input.servers)) {
385
+ const metadata = input.metadata[serverName];
386
+ if (!metadata) continue;
387
+ const toolFilter = selectedServers.has(serverName) ? true : selectedTools.get(serverName);
388
+ if (!toolFilter) continue;
389
+ const prefix = normalizeMcpToolPrefix(server.toolPrefix ?? input.toolPrefix);
390
+ for (const tool of Array.isArray(metadata.tools) ? metadata.tools : []) {
391
+ if (typeof tool?.name !== "string" || !tool.name) continue;
392
+ if (toolFilter !== true && !toolFilter.has(tool.name)) continue;
393
+ if (!isToolAllowed(tool.name, serverName, prefix, server.includeTools, server.excludeTools)) continue;
394
+ const name = formatToolName(tool.name, serverName, prefix);
395
+ if (BUILTIN_TOOL_NAMES.has(name) || seenNames.has(name)) continue;
396
+ seenNames.add(name);
397
+ selections.push({ name, selector: `${serverName}/${tool.name}` });
398
+ }
399
+ if (server.exposeResources === false) continue;
400
+ for (const resource of Array.isArray(metadata.resources) ? metadata.resources : []) {
401
+ if (typeof resource?.name !== "string" || !resource.name || typeof resource.uri !== "string" || !resource.uri) continue;
402
+ const baseName = `get_${resourceNameToToolName(resource.name)}`;
403
+ if (toolFilter !== true && !toolFilter.has(baseName)) continue;
404
+ if (!isToolAllowed(baseName, serverName, prefix, server.includeTools, server.excludeTools)) continue;
405
+ const name = formatToolName(baseName, serverName, prefix);
406
+ if (BUILTIN_TOOL_NAMES.has(name) || seenNames.has(name)) continue;
407
+ seenNames.add(name);
408
+ selections.push({ name, selector: `${serverName}/${baseName}` });
409
+ }
410
+ }
411
+ const unresolvedSelectors = selectors.filter(
412
+ (selector) => selector.includes("/") ? !selections.some((selection) => selection.selector === selector) : !selections.some((selection) => selection.selector.startsWith(`${selector}/`))
413
+ );
414
+ return { selections, unresolvedSelectors };
415
+ }
416
+ function normalizeMcpToolPrefix(value) {
417
+ return value === "none" || value === "short" || value === "mcp" || value === "server" ? value : "server";
418
+ }
419
+ function formatUnresolvedMcpDirectToolSelectors(selectors) {
420
+ return `Unresolved MCP direct-tool selectors: ${selectors.join(", ")}. Direct MCP tools require a matching configured server and fresh metadata cache; runtime-registered servers require a host/pi-mcp-adapter handoff before child launch.`;
421
+ }
422
+ function getServerPrefix(serverName, mode) {
423
+ if (mode === "none") return "";
424
+ if (mode === "short") return sanitizeServerPrefix(serverName.replace(/-?mcp$/i, "")) || "mcp";
425
+ if (mode === "mcp") return `mcp__${sanitizeServerPrefix(serverName)}`;
426
+ return sanitizeServerPrefix(serverName);
427
+ }
428
+ function sanitizeServerPrefix(serverName) {
429
+ return Array.from(serverName, (char) => /^[A-Za-z0-9_-]$/.test(char) ? char : `_${char.codePointAt(0).toString(16)}_`).join("");
430
+ }
431
+ function formatToolName(toolName, serverName, prefix) {
432
+ const serverPrefix = getServerPrefix(serverName, prefix);
433
+ const sanitized = toolName.replace(/\./g, "_");
434
+ if (serverPrefix && sanitized.startsWith(`${serverPrefix}_`) && sanitized.length > serverPrefix.length + 1) {
435
+ return sanitized;
436
+ }
437
+ return serverPrefix ? `${serverPrefix}_${sanitized}` : sanitized;
438
+ }
439
+ function isToolAllowed(toolName, serverName, prefix, includeTools, excludeTools) {
440
+ const candidates = toolNameCandidates(toolName, serverName, prefix);
441
+ return (!Array.isArray(includeTools) || includeTools.length === 0 || matchesToolPatterns(candidates, includeTools)) && !matchesToolPatterns(candidates, excludeTools);
442
+ }
443
+ function toolNameCandidates(toolName, serverName, prefix) {
444
+ return /* @__PURE__ */ new Set([
445
+ toolName,
446
+ `mcp_${toolName}`,
447
+ formatToolName(toolName, serverName, prefix),
448
+ formatToolName(toolName, serverName, "server"),
449
+ formatToolName(toolName, serverName, "short"),
450
+ formatToolName(toolName, serverName, "mcp"),
451
+ formatToolName(toolName, serverName, "none")
452
+ ]);
453
+ }
454
+ function matchesToolPatterns(candidates, patterns) {
455
+ if (!Array.isArray(patterns) || patterns.length === 0) return false;
456
+ for (const pattern of patterns) {
457
+ if (typeof pattern !== "string") continue;
458
+ const normalizedPattern = normalizeToolName(pattern);
459
+ const matcher = normalizedPattern.includes("*") || normalizedPattern.includes("?") ? globToRegExp(normalizedPattern) : void 0;
460
+ for (const candidate of candidates) {
461
+ const normalizedCandidate = normalizeToolName(candidate);
462
+ if (matcher ? matcher.test(normalizedCandidate) : normalizedCandidate === normalizedPattern) return true;
463
+ }
464
+ }
465
+ return false;
466
+ }
467
+ function globToRegExp(pattern) {
468
+ const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
469
+ return new RegExp(`^${escaped}$`);
470
+ }
471
+ function normalizeToolName(value) {
472
+ return value.replace(/-/g, "_");
473
+ }
474
+ function resourceNameToToolName(name) {
475
+ let result = name.replace(/[^a-zA-Z0-9]/g, "_").replace(/_+/g, "_").replace(/^_+/, "").replace(/_+$/, "").toLowerCase();
476
+ if (!result || /^\d/.test(result)) result = `resource${result ? `_${result}` : ""}`;
477
+ return result;
478
+ }
479
+
480
+ // src/runs/shared/mcp-direct-tool-allowlist.ts
481
+ var CACHE_VERSION = 1;
482
+ var CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
483
+ var GENERIC_GLOBAL_CONFIG_PATH = path2.join(os2.homedir(), ".config", "mcp", "mcp.json");
484
+ var IMPORT_PATHS = {
485
+ cursor: [path2.join(os2.homedir(), ".cursor", "mcp.json")],
486
+ "claude-code": [
487
+ path2.join(os2.homedir(), ".claude", "mcp.json"),
488
+ path2.join(os2.homedir(), ".claude.json"),
489
+ path2.join(os2.homedir(), ".claude", "claude_desktop_config.json")
490
+ ],
491
+ "claude-desktop": [path2.join(os2.homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json")],
492
+ codex: [path2.join(os2.homedir(), ".codex", "config.json")],
493
+ windsurf: [path2.join(os2.homedir(), ".windsurf", "mcp.json")],
494
+ vscode: [".vscode/mcp.json"]
495
+ };
496
+ var MCP_RUNTIME_SNAPSHOT_EVENT = "pi-mcp-adapter:runtime-snapshot:v1";
497
+ var MCP_RUNTIME_SNAPSHOT_VERSION = 1;
498
+ function resolveMcpDirectToolResolution(mcpDirectTools, cwd = process.cwd(), runtimeSnapshotHost, configOverride) {
499
+ const selectors = normalizeMcpDirectToolSelectors(mcpDirectTools);
500
+ if (selectors.length === 0) return { selections: [], unresolvedSelectors: [] };
501
+ if (usesBuiltinMcp(runtimeSnapshotHost)) {
502
+ return resolveBuiltinMcpSelections(selectors, runtimeSnapshotHost.getAllTools?.() ?? []);
503
+ }
504
+ const config = configOverride ?? loadMcpConfig(cwd);
505
+ const { servers: selectedServers, tools: selectedTools } = parseMcpDirectToolSelectors(selectors);
506
+ const runtimeSelectionServers = /* @__PURE__ */ new Set([...selectedServers, ...selectedTools.keys()]);
507
+ const runtimeServers = resolveRuntimeMcpServers(config, runtimeSelectionServers, runtimeSnapshotHost);
508
+ const resolvedConfig = Object.keys(runtimeServers).length > 0 ? mergeConfigs(config, { mcpServers: runtimeServers }) : config;
509
+ validateSelectedServerDefinitions(resolvedConfig, selectors);
510
+ const runtime = Object.keys(runtimeServers).length > 0 ? { mcpConfig: resolvedConfig, runtimeServerNames: Object.keys(runtimeServers) } : {};
511
+ const cache = loadMetadataCache();
512
+ if (!cache) return { selections: [], unresolvedSelectors: selectors, ...runtime };
513
+ const validMetadata = {};
514
+ for (const [serverName, definition] of Object.entries(resolvedConfig.mcpServers)) {
515
+ const serverCache = cache.servers[serverName];
516
+ if (isServerCacheValid(serverCache, definition)) validMetadata[serverName] = serverCache;
517
+ }
518
+ const grant = planMcpDirectToolGrant({
519
+ selectors,
520
+ servers: resolvedConfig.mcpServers,
521
+ metadata: validMetadata,
522
+ toolPrefix: resolvedConfig.settings?.toolPrefix
523
+ });
524
+ return {
525
+ selections: grant.selections,
526
+ unresolvedSelectors: grant.unresolvedSelectors,
527
+ ...runtime
528
+ };
529
+ }
530
+ function usesBuiltinMcp(host) {
531
+ const commands = host?.getCommands?.() ?? [];
532
+ return commands.find((command) => command.name === "mcp")?.sourceInfo.path === "builtin:mcp" && !commands.some((command) => /^mcp-adapter(?::\d+)?$/.test(command.name));
533
+ }
534
+ function resolveBuiltinMcpSelections(selectors, tools) {
535
+ const selections = [];
536
+ const unresolvedSelectors = [];
537
+ for (const selector of selectors) {
538
+ const slash = selector.indexOf("/");
539
+ const server = slash === -1 ? selector : selector.slice(0, slash);
540
+ const inServer = tools.filter((tool) => tool.namespace?.name === `mcp__${server.replace(/-/g, "_")}`);
541
+ const toolName = slash === -1 ? void 0 : builtinMcpToolNames(server, selector.slice(slash + 1)).find((name) => inServer.some((tool) => tool.name === name));
542
+ const matches = inServer.filter((tool) => tool.exposure !== "hidden" && (slash === -1 || tool.name === toolName));
543
+ if (matches.length === 0) unresolvedSelectors.push(selector);
544
+ for (const tool of matches) {
545
+ if (!selections.some((selection) => selection.name === tool.name)) selections.push({ name: tool.name, selector });
546
+ }
547
+ }
548
+ return { selections, unresolvedSelectors, builtin: true };
549
+ }
550
+ function builtinMcpToolNames(server, tool) {
551
+ const name = `mcp__${server}__${tool}`.replace(/[^A-Za-z0-9_]/g, "_");
552
+ const hash = createHash("sha256").update(`${server}\0${tool}`).digest("hex").slice(0, 8);
553
+ const suffixed = `${name.slice(0, 64 - hash.length - 1)}_${hash}`;
554
+ return name.length <= 64 ? [suffixed, name] : [suffixed];
555
+ }
556
+ function formatUnresolvedBuiltinMcpSelectors(agentName, selectors) {
557
+ const subject = agentName ? `Agent '${agentName}'` : "Subagent";
558
+ return `${subject} selects MCP tools that Pi's built-in MCP does not offer: ${selectors.map((selector) => `mcp:${selector}`).join(", ")}. The server may be missing, disconnected, still connecting, or its tools hidden; check /mcp.`;
559
+ }
560
+ function extensionOnlyMcpServers(selections, host, cwd, projectTrusted) {
561
+ const registered = new Set(host.getMcpServers?.().map(({ name }) => name));
562
+ const servers = [...new Set(selections.map(({ selector }) => selector.split("/")[0]))].filter((server) => registered.has(server));
563
+ if (servers.length === 0) return [];
564
+ const files = [path2.join(getAgentDir(), "mcp.json"), ...projectTrusted ? [path2.join(cwd, ".pi", "mcp.json")] : []];
565
+ const configured = new Set(files.flatMap((file) => {
566
+ let parsed;
567
+ try {
568
+ parsed = JSON.parse(fs2.readFileSync(file, "utf-8"));
569
+ } catch {
570
+ return [];
571
+ }
572
+ return isRecord2(parsed) && isRecord2(parsed.mcpServers) ? Object.keys(parsed.mcpServers) : [];
573
+ }));
574
+ return servers.filter((server) => !configured.has(server));
575
+ }
576
+ function loadMetadataCache() {
577
+ const cachePath = path2.join(getAgentDir(), "mcp-cache.json");
578
+ let parsed;
579
+ try {
580
+ parsed = JSON.parse(fs2.readFileSync(cachePath, "utf-8"));
581
+ } catch {
582
+ return null;
583
+ }
584
+ if (!isRecord2(parsed) || parsed.version !== CACHE_VERSION || !isRecord2(parsed.servers)) return null;
585
+ const servers = {};
586
+ for (const [name, value] of Object.entries(parsed.servers)) {
587
+ const entry = parseServerCacheEntry(value);
588
+ if (entry) servers[name] = entry;
589
+ }
590
+ return { version: CACHE_VERSION, servers };
591
+ }
592
+ function parseServerCacheEntry(value) {
593
+ if (!isRecord2(value)) return void 0;
594
+ if (value.configHash !== void 0 && typeof value.configHash !== "string") return void 0;
595
+ if (value.cachedAt !== void 0 && (typeof value.cachedAt !== "number" || !Number.isFinite(value.cachedAt))) return void 0;
596
+ if (value.tools !== void 0 && !Array.isArray(value.tools)) return void 0;
597
+ if (value.resources !== void 0 && !Array.isArray(value.resources)) return void 0;
598
+ const tools = value.tools?.map(parseCachedTool);
599
+ const resources = value.resources?.map(parseCachedResource);
600
+ if (tools && !tools.every((entry) => entry !== void 0)) return void 0;
601
+ if (resources && !resources.every((entry) => entry !== void 0)) return void 0;
602
+ return {
603
+ ...value.configHash !== void 0 ? { configHash: value.configHash } : {},
604
+ ...value.cachedAt !== void 0 ? { cachedAt: value.cachedAt } : {},
605
+ ...tools ? { tools } : {},
606
+ ...resources ? { resources } : {}
607
+ };
608
+ }
609
+ function parseCachedTool(value) {
610
+ if (!isRecord2(value) || value.name !== void 0 && typeof value.name !== "string") return void 0;
611
+ return value.name === void 0 ? {} : { name: value.name };
612
+ }
613
+ function parseCachedResource(value) {
614
+ if (!isRecord2(value)) return void 0;
615
+ if (value.uri !== void 0 && typeof value.uri !== "string") return void 0;
616
+ if (value.name !== void 0 && typeof value.name !== "string") return void 0;
617
+ return {
618
+ ...value.uri !== void 0 ? { uri: value.uri } : {},
619
+ ...value.name !== void 0 ? { name: value.name } : {}
620
+ };
621
+ }
622
+ function resolveRuntimeMcpServers(config, selectedServers, runtimeSnapshotHost) {
623
+ if (!runtimeSnapshotHost) return {};
624
+ const runtimeServers = {};
625
+ for (const serverName of selectedServers) {
626
+ if (Object.hasOwn(config.mcpServers, serverName)) continue;
627
+ try {
628
+ const snapshot = getRuntimeMcpServerSnapshot(runtimeSnapshotHost, serverName);
629
+ runtimeServers[serverName] = snapshot.definition;
630
+ } catch {
631
+ }
632
+ }
633
+ return runtimeServers;
634
+ }
635
+ function getRuntimeMcpServerSnapshot(host, name) {
636
+ const request = {
637
+ version: MCP_RUNTIME_SNAPSHOT_VERSION,
638
+ name
639
+ };
640
+ host.events.emit(MCP_RUNTIME_SNAPSHOT_EVENT, request);
641
+ if (!request.result) throw new Error("pi-mcp-adapter is not installed for this Pi instance");
642
+ if (!request.result.ok) throw request.result.error;
643
+ const snapshot = request.result.snapshot;
644
+ if (!snapshot || snapshot.name !== name || snapshot.runtime !== true || snapshot.persisted !== false || !isMcpServerDefinition(snapshot.definition)) {
645
+ throw new Error(`Invalid MCP runtime snapshot for server "${name}"`);
646
+ }
647
+ return snapshot;
648
+ }
649
+ function loadMcpConfig(cwd) {
650
+ const resolvedCwd = path2.resolve(cwd);
651
+ const projectRoot = findConfiguredProjectRoot(resolvedCwd) ?? resolvedCwd;
652
+ let config = { mcpServers: {} };
653
+ for (const sourcePath of getConfigPaths(projectRoot)) {
654
+ const loaded = readConfig(sourcePath);
655
+ if (!loaded) continue;
656
+ config = mergeConfigs(config, expandImports(loaded, projectRoot));
657
+ }
658
+ const packageServers = loadPackageMcpServers(projectRoot);
659
+ const pluginServers = loadAgentPluginMcpServers(config.settings?.agentPluginPaths, projectRoot);
660
+ const packageOnlyServers = Object.fromEntries(
661
+ Object.entries(packageServers).filter(([name]) => !Object.hasOwn(pluginServers, name))
662
+ );
663
+ return mergeConfigs(
664
+ { mcpServers: packageOnlyServers },
665
+ mergeConfigs({ mcpServers: pluginServers }, config)
666
+ );
667
+ }
668
+ function getConfigPaths(projectRoot) {
669
+ const agentDir = getAgentDir();
670
+ const projectDir = getProjectConfigDir(projectRoot);
671
+ const candidates = [
672
+ GENERIC_GLOBAL_CONFIG_PATH,
673
+ path2.join(agentDir, "mcp-adapter.json"),
674
+ path2.resolve(projectRoot, ".mcp.json"),
675
+ path2.join(projectDir, "mcp-adapter.json")
676
+ ];
677
+ return [...new Set(candidates)];
678
+ }
679
+ function readConfig(configPath) {
680
+ let parsed;
681
+ try {
682
+ parsed = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
683
+ } catch {
684
+ return null;
685
+ }
686
+ return validateConfig(parsed);
687
+ }
688
+ function validateConfig(raw) {
689
+ if (!isRecord2(raw)) return { mcpServers: {} };
690
+ const obj = raw;
691
+ const servers = obj.mcpServers ?? obj["mcp-servers"] ?? {};
692
+ return {
693
+ mcpServers: parseServerEntries(servers),
694
+ imports: Array.isArray(obj.imports) ? obj.imports.filter((value) => isImportKind(value)) : void 0,
695
+ settings: parseSettings(obj.settings)
696
+ };
697
+ }
698
+ function parseServerEntries(value) {
699
+ if (!isRecord2(value)) return {};
700
+ return Object.fromEntries(Object.entries(value).filter((entry) => isMcpServerDefinition(entry[1])));
701
+ }
702
+ function parseSettings(value) {
703
+ if (!isRecord2(value)) return void 0;
704
+ const toolPrefix = value.toolPrefix === "server" || value.toolPrefix === "short" || value.toolPrefix === "none" || value.toolPrefix === "mcp" ? value.toolPrefix : void 0;
705
+ const directTools = typeof value.directTools === "boolean" ? value.directTools : void 0;
706
+ const settings = {
707
+ ...toolPrefix ? { toolPrefix } : {},
708
+ ...directTools !== void 0 ? { directTools } : {},
709
+ ...value.agentPluginPaths !== void 0 ? { agentPluginPaths: value.agentPluginPaths } : {}
710
+ };
711
+ return Object.keys(settings).length ? settings : void 0;
712
+ }
713
+ function mergeConfigs(base, next) {
714
+ const imports = [...base.imports ?? [], ...next.imports ?? []];
715
+ return {
716
+ mcpServers: { ...base.mcpServers, ...next.mcpServers },
717
+ imports: imports.length ? [...new Set(imports)] : void 0,
718
+ settings: next.settings ? { ...base.settings, ...next.settings } : base.settings
719
+ };
720
+ }
721
+ function expandImports(config, cwd) {
722
+ if (!config.imports?.length) return config;
723
+ const importedServers = {};
724
+ for (const importKind of config.imports) {
725
+ const importPath = resolveImportPath(importKind, cwd);
726
+ if (!importPath) continue;
727
+ let imported;
728
+ try {
729
+ imported = JSON.parse(fs2.readFileSync(importPath, "utf-8"));
730
+ } catch {
731
+ continue;
732
+ }
733
+ for (const [name, definition] of Object.entries(extractServers(imported, importKind))) {
734
+ if (!importedServers[name]) importedServers[name] = definition;
735
+ }
736
+ }
737
+ return {
738
+ imports: config.imports,
739
+ settings: config.settings,
740
+ mcpServers: { ...importedServers, ...config.mcpServers }
741
+ };
742
+ }
743
+ function resolveImportPath(importKind, cwd) {
744
+ for (const candidate of IMPORT_PATHS[importKind]) {
745
+ const fullPath = candidate.startsWith(".") ? path2.resolve(cwd, candidate) : candidate;
746
+ if (fs2.existsSync(fullPath)) return fullPath;
747
+ }
748
+ return null;
749
+ }
750
+ function extractServers(config, kind) {
751
+ if (!isRecord2(config)) return {};
752
+ const obj = config;
753
+ const servers = kind === "cursor" || kind === "windsurf" || kind === "vscode" ? obj.mcpServers ?? obj["mcp-servers"] : obj.mcpServers;
754
+ return parseServerEntries(servers);
755
+ }
756
+ function validateSelectedServerDefinitions(config, selectors) {
757
+ const { servers, tools } = parseMcpDirectToolSelectors(selectors);
758
+ for (const serverName of /* @__PURE__ */ new Set([...servers, ...tools.keys()])) {
759
+ const definition = config.mcpServers[serverName];
760
+ if (definition) computeMcpServerHash(definition);
761
+ }
762
+ }
763
+ function isServerCacheValid(entry, definition) {
764
+ if (!entry || entry.configHash !== computeMcpServerHash(definition)) return false;
765
+ if (!entry.cachedAt || typeof entry.cachedAt !== "number") return false;
766
+ return Date.now() - entry.cachedAt <= CACHE_MAX_AGE_MS;
767
+ }
768
+ function computeMcpServerHash(definition) {
769
+ const isStdio = definition.command !== void 0;
770
+ const literalEnv = isStdio && definition.literalEnv === true;
771
+ const identity = {
772
+ command: resolveConfigPath(definition.command),
773
+ args: definition.args,
774
+ socket: resolveConfigPath(definition.socket),
775
+ env: literalEnv ? definition.env : interpolateEnvRecord(definition.env),
776
+ ...isStdio ? { inheritEnv: definition.inheritEnv !== false, literalEnv } : {},
777
+ cwd: resolveConfigPath(definition.cwd),
778
+ url: resolveServerUrl(definition),
779
+ headers: interpolateEnvRecord(definition.headers),
780
+ requestHeadersCommand: definition.requestHeadersCommand ? {
781
+ command: interpolateEnvVars(definition.requestHeadersCommand.command),
782
+ args: definition.requestHeadersCommand.args?.map(interpolateEnvVars),
783
+ env: interpolateEnvRecord(definition.requestHeadersCommand.env),
784
+ timeoutMs: definition.requestHeadersCommand.timeoutMs
785
+ } : void 0,
786
+ auth: definition.auth,
787
+ bearerToken: resolveBearerToken(definition),
788
+ bearerTokenEnv: definition.bearerTokenEnv,
789
+ exposeResources: definition.exposeResources,
790
+ includeTools: definition.includeTools,
791
+ excludeTools: definition.excludeTools,
792
+ protocolVersion: definition.protocolVersion
793
+ };
794
+ return createHash("sha256").update(stableStringify(identity)).digest("hex");
795
+ }
796
+ function isImportKind(value) {
797
+ return typeof value === "string" && Object.hasOwn(IMPORT_PATHS, value);
798
+ }
799
+ function isRecord2(value) {
800
+ return value !== null && typeof value === "object" && !Array.isArray(value);
801
+ }
802
+ function interpolateEnvRecord(values) {
803
+ if (!values) return void 0;
804
+ return Object.fromEntries(Object.entries(values).map(([key, value]) => [key, interpolateSecretExpression(value)]));
805
+ }
806
+ function interpolateEnvVars(value) {
807
+ return value.replace(/\$\{(\w+)\}/g, (_, name) => process.env[name] ?? "").replace(/\$env:(\w+)/g, (_, name) => process.env[name] ?? "").replace(/\{env:(\w+)\}/g, (_, name) => process.env[name] ?? "");
808
+ }
809
+ function interpolateSecretExpression(value) {
810
+ if (value.startsWith("!!")) return interpolateEnvVars(value.slice(1));
811
+ return value.startsWith("!") ? value : interpolateEnvVars(value);
812
+ }
813
+ function getMissingEnvVars(value) {
814
+ const missing = /* @__PURE__ */ new Set();
815
+ for (const match of value.matchAll(/\$\{(\w+)\}|\$env:(\w+)|\{env:(\w+)\}/g)) {
816
+ const name = match[1] ?? match[2] ?? match[3];
817
+ if (name && process.env[name] === void 0) missing.add(name);
818
+ }
819
+ return [...missing];
820
+ }
821
+ function resolveServerUrl(definition) {
822
+ if (definition.url == null) return void 0;
823
+ if (typeof definition.url !== "string") throw new Error("MCP server URL must be a string");
824
+ const missing = getMissingEnvVars(definition.url);
825
+ if (missing.length > 0) {
826
+ throw new Error(`Missing environment variable${missing.length === 1 ? "" : "s"} in MCP server URL: ${missing.join(", ")}`);
827
+ }
828
+ const resolved = interpolateEnvVars(definition.url);
829
+ try {
830
+ new URL(resolved);
831
+ } catch (error) {
832
+ throw new Error(`Invalid MCP server URL after environment interpolation: ${resolved}`, { cause: error });
833
+ }
834
+ return resolved;
835
+ }
836
+ function resolveConfigPath(value) {
837
+ if (value === void 0) return void 0;
838
+ const resolved = interpolateEnvVars(value);
839
+ if (resolved === "~") return os2.homedir();
840
+ if (resolved.startsWith("~/") || resolved.startsWith("~\\")) return path2.join(os2.homedir(), resolved.slice(2));
841
+ return resolved;
842
+ }
843
+ function resolveBearerToken(definition) {
844
+ if (definition.bearerToken !== void 0) return interpolateSecretExpression(definition.bearerToken);
845
+ return definition.bearerTokenEnv ? process.env[definition.bearerTokenEnv] : void 0;
846
+ }
847
+ function stableStringify(value) {
848
+ if (value === null || value === void 0 || typeof value !== "object") {
849
+ const serialized = JSON.stringify(value);
850
+ return serialized === void 0 ? "undefined" : serialized;
851
+ }
852
+ if (Array.isArray(value)) return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
853
+ const obj = value;
854
+ return `{${Object.keys(obj).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(obj[key])}`).join(",")}}`;
855
+ }
856
+
857
+ // src/shared/runtime-module-path.ts
858
+ import * as fs3 from "node:fs";
859
+ import * as path3 from "node:path";
860
+ var RUNTIME_MODULE_EXTENSIONS = [".js", ".ts"];
861
+ function resolveRuntimeModuleExtension(dir, basename) {
862
+ return RUNTIME_MODULE_EXTENSIONS.find((extension) => fs3.existsSync(path3.join(dir, `${basename}${extension}`))) ?? ".js";
863
+ }
864
+ function resolveRuntimeModulePath(dir, basename) {
865
+ return path3.normalize(path3.join(dir, `${basename}${resolveRuntimeModuleExtension(dir, basename)}`));
866
+ }
867
+
868
+ // src/runs/shared/profile-extensions.ts
869
+ import * as fs4 from "node:fs";
870
+ import * as path4 from "node:path";
871
+ function resolveSandboxExtensionForProfile(profileName) {
872
+ validateSandboxProfileName(profileName, "sandbox profile");
873
+ return resolveSandboxExtension();
874
+ }
875
+ function resolveSandboxExtension() {
876
+ const agentDir = getAgentDir();
877
+ const candidates = [
878
+ path4.join(agentDir, "npm", "node_modules", "@xzzpig", "pi-sandbox"),
879
+ path4.join(agentDir, "npm", "node_modules", "pi-sandbox"),
880
+ path4.join(agentDir, "extensions", "pi-sandbox")
881
+ ];
882
+ const errors = [];
883
+ let foundPackage = false;
884
+ for (const extDir of candidates) {
885
+ if (!fs4.existsSync(extDir)) continue;
886
+ foundPackage = true;
887
+ const pkgPath = path4.join(extDir, "package.json");
888
+ if (!fs4.existsSync(pkgPath)) {
889
+ errors.push(new Error(`Sandbox package manifest is missing at ${pkgPath}.`));
890
+ continue;
891
+ }
892
+ try {
893
+ const parsed = JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
894
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
895
+ throw new Error("manifest root must be an object");
896
+ }
897
+ const manifest = parsed;
898
+ if (manifest.name !== "@xzzpig/pi-sandbox" && manifest.name !== "pi-sandbox") {
899
+ throw new Error(`Sandbox package manifest at ${pkgPath} must declare name '@xzzpig/pi-sandbox' or 'pi-sandbox'.`);
900
+ }
901
+ const extensions = manifest.pi?.extensions;
902
+ const entry = Array.isArray(extensions) ? extensions[0] : void 0;
903
+ if (typeof entry !== "string" || !entry.trim()) {
904
+ throw new Error(`Sandbox package manifest at ${pkgPath} must declare pi.extensions[0] as a non-empty string.`);
905
+ }
906
+ if (path4.isAbsolute(entry)) {
907
+ throw new Error(`Sandbox extension entry ${JSON.stringify(entry)} in ${pkgPath} must be relative to the package directory.`);
908
+ }
909
+ const resolved = path4.resolve(extDir, entry);
910
+ const relative3 = path4.relative(extDir, resolved);
911
+ if (!relative3 || relative3 === ".." || relative3.startsWith(`..${path4.sep}`) || path4.isAbsolute(relative3)) {
912
+ throw new Error(`Sandbox extension entry ${JSON.stringify(entry)} in ${pkgPath} must remain inside ${extDir}.`);
913
+ }
914
+ if (!fs4.existsSync(resolved) || !fs4.statSync(resolved).isFile()) {
915
+ throw new Error(`Sandbox extension entry ${JSON.stringify(entry)} in ${pkgPath} does not resolve to a file at ${resolved}.`);
916
+ }
917
+ const realPackageRoot = fs4.realpathSync(extDir);
918
+ const realEntry = fs4.realpathSync(resolved);
919
+ const realRelative = path4.relative(realPackageRoot, realEntry);
920
+ if (!realRelative || realRelative === ".." || realRelative.startsWith(`..${path4.sep}`) || path4.isAbsolute(realRelative)) {
921
+ throw new Error(`Sandbox extension entry ${JSON.stringify(entry)} in ${pkgPath} resolves outside ${extDir}.`);
922
+ }
923
+ return resolved;
924
+ } catch (error) {
925
+ const message = error instanceof Error ? error.message : String(error);
926
+ errors.push(message.startsWith("Sandbox") ? new Error(message) : new Error(`Cannot read sandbox package manifest at ${pkgPath}: ${message}`));
927
+ }
928
+ }
929
+ if (errors.length > 0) throw errors[0];
930
+ if (!foundPackage) {
931
+ throw new Error(`pi-sandbox is not installed; cannot launch a child with sandbox profile.`);
932
+ }
933
+ throw new Error(`No usable pi-sandbox extension manifest was found under '${agentDir}'.`);
934
+ }
935
+ function resolveProfileExtensions(input) {
936
+ const { capabilityCeiling, permSystemExt } = input;
937
+ const sandboxProfile = input.sandbox === void 0 ? void 0 : validateSandboxProfileName(input.sandbox, "sandbox profile");
938
+ if (sandboxProfile && capabilityCeiling?.denyExtensions) {
939
+ throw new Error(`Sandbox profile '${sandboxProfile}' requires the pi-sandbox child extension, but this launch denies child extensions.`);
940
+ }
941
+ const permissionProfile = input.permissionProfile === void 0 ? void 0 : validatePermissionProfileName(input.permissionProfile, "permission profile");
942
+ if (permissionProfile && capabilityCeiling?.denyExtensions) {
943
+ throw new Error(`Permission profile '${permissionProfile}' requires the pi-permission-system child extension, but this launch denies child extensions.`);
944
+ }
945
+ const permSystemExtForProfile = permissionProfile !== void 0 && permSystemExt === void 0 ? resolvePermissionSystemExtension() : void 0;
946
+ if (permissionProfile !== void 0 && permSystemExt === void 0 && permSystemExtForProfile === void 0) {
947
+ throw new Error(`Permission profile '${permissionProfile}' cannot be enabled: pi-permission-system is not installed; cannot launch a child with a permission profile.`);
948
+ }
949
+ const effectivePermSystemExt = permSystemExt ?? permSystemExtForProfile;
950
+ let sandboxExtension;
951
+ if (sandboxProfile) {
952
+ try {
953
+ sandboxExtension = resolveSandboxExtensionForProfile(sandboxProfile);
954
+ } catch (error) {
955
+ const message = error instanceof Error ? error.message : String(error);
956
+ throw new Error(`Sandbox profile '${sandboxProfile}' cannot be enabled: ${message}`);
957
+ }
958
+ }
959
+ return {
960
+ ...sandboxExtension ? { sandboxExtension } : {},
961
+ ...effectivePermSystemExt ? { effectivePermSystemExt } : {}
962
+ };
963
+ }
964
+
965
+ // src/runs/shared/child-tool-plan.ts
966
+ var MAX_LAUNCH_RESOLVED_EXTENSION_IDS = 32;
967
+ var RUNTIME_EXTENSION_DIR = path5.dirname(fileURLToPath(new URL("../src/runs/shared/child-tool-plan.js", import.meta.url).href));
968
+ var FANOUT_CHILD_EXTENSION_DIR = path5.join(RUNTIME_EXTENSION_DIR, "..", "..", "extension");
969
+ var SANDBOX_PROFILE_GUARD_EXTENSION_PATH = path5.join(RUNTIME_EXTENSION_DIR, "sandbox-profile-guard.ts");
970
+ var SUBAGENT_RUNTIME_EXTENSION_PATHS = new Set([
971
+ path5.join(RUNTIME_EXTENSION_DIR, "subagent-prompt-runtime"),
972
+ path5.join(RUNTIME_EXTENSION_DIR, "fast-mode-extension"),
973
+ path5.join(FANOUT_CHILD_EXTENSION_DIR, "fanout-child")
974
+ ].flatMap((base) => RUNTIME_MODULE_EXTENSIONS.map((extension) => path5.normalize(`${base}${extension}`))));
975
+ function isSubagentRuntimeExtensionPath(extensionPath) {
976
+ return SUBAGENT_RUNTIME_EXTENSION_PATHS.has(path5.normalize(extensionPath));
977
+ }
978
+ var PI_BUILTIN_TOOL_NAMES = /* @__PURE__ */ new Set(["read", "bash", "powershell", "edit", "write", "grep", "find", "ls"]);
979
+ var FAST_MODE_PROVIDER_PREFIX = "openai-codex/";
980
+ var OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH = 64;
981
+ function deriveForkPromptCacheKey(parentSessionId) {
982
+ const parent = parentSessionId?.trim();
983
+ if (!parent) return void 0;
984
+ const digest = createHash2("sha256").update(parent).digest("hex").slice(0, OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH - "pi-fork:".length);
985
+ return `pi-fork:${digest}`;
986
+ }
987
+ function sanitizeSupervisorChannelSegment(value) {
988
+ return value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "unknown";
989
+ }
990
+ function supervisorChannelDir(runId, agent, childIndex) {
991
+ return path5.join(
992
+ TEMP_ROOT_DIR,
993
+ "supervisor-channels",
994
+ `${sanitizeSupervisorChannelSegment(runId)}-${sanitizeSupervisorChannelSegment(agent)}-${childIndex}`
995
+ );
996
+ }
997
+ function applyThinkingSuffix(model, thinking, replaceExisting = false) {
998
+ if (!model || !thinking) return model;
999
+ const colonIdx = model.lastIndexOf(":");
1000
+ if (colonIdx !== -1 && THINKING_LEVELS.some((level) => level === model.substring(colonIdx + 1))) {
1001
+ return replaceExisting ? `${model.slice(0, colonIdx)}:${thinking}` : model;
1002
+ }
1003
+ return `${model}:${thinking}`;
1004
+ }
1005
+ function stripThinkingSuffix(model) {
1006
+ const colonIdx = model.lastIndexOf(":");
1007
+ if (colonIdx === -1) return model;
1008
+ return THINKING_LEVELS.some((level) => level === model.substring(colonIdx + 1)) ? model.slice(0, colonIdx) : model;
1009
+ }
1010
+ function resolveFastModeExtension(input) {
1011
+ if (!input.fast) return [];
1012
+ const candidates = (input.model ? [input.model] : []).map(stripThinkingSuffix);
1013
+ if (candidates.length === 0) {
1014
+ throw new Error(`fast mode requires an explicit supported native OpenAI-Codex model${input.agentName ? ` for agent '${input.agentName}'` : ""}.`);
1015
+ }
1016
+ const unsupported = candidates.filter((model) => !model.startsWith(FAST_MODE_PROVIDER_PREFIX));
1017
+ if (unsupported.length > 0) {
1018
+ throw new Error(`fast mode supports only native ${FAST_MODE_PROVIDER_PREFIX}* models; unsupported model${unsupported.length === 1 ? "" : "s"}: ${unsupported.join(", ")}.`);
1019
+ }
1020
+ return [resolveRuntimeModulePath(RUNTIME_EXTENSION_DIR, "fast-mode-extension")];
1021
+ }
1022
+ function extensionIdentifier(value) {
1023
+ return `sha256:${createHash2("sha256").update(path5.normalize(value.trim())).digest("hex").slice(0, 16)}`;
1024
+ }
1025
+ function boundedExtensionIdentifiers(values) {
1026
+ const ids = [...new Set(values.map(extensionIdentifier))];
1027
+ return {
1028
+ ids: ids.slice(0, MAX_LAUNCH_RESOLVED_EXTENSION_IDS),
1029
+ omitted: Math.max(0, ids.length - MAX_LAUNCH_RESOLVED_EXTENSION_IDS)
1030
+ };
1031
+ }
1032
+ function hasPermissionRules(rules) {
1033
+ return rules !== void 0 && Object.keys(rules).length > 0;
1034
+ }
1035
+ function formatRuntimeSnapshotMcpServersError(agentName, serverNames) {
1036
+ const subject = agentName ? `Agent '${agentName}'` : "Subagent";
1037
+ return `${subject} selects MCP tools from servers that exist only in pi-mcp-adapter's runtime snapshot (${serverNames.join(", ")}). MCP servers from the runtime snapshot cannot be provided to in-process children; MCP tools must come from an ambient adapter extension in a background child (\`async: true\`), so add the server to the adapter's configuration file instead.`;
1038
+ }
1039
+ function isToolExtensionPath(entry) {
1040
+ return entry.includes("/") || entry.endsWith(".ts") || entry.endsWith(".js");
1041
+ }
1042
+ function assertNoToolModifierEntries(agentName, tools) {
1043
+ const entries = tools.filter((entry) => /^[+-]/u.test(entry) && !isToolExtensionPath(entry));
1044
+ if (entries.length === 0) return;
1045
+ const subject = agentName ? `Agent '${agentName}'` : "Subagent";
1046
+ throw new Error(`${subject} lists Pi tool modifier ${entries.length === 1 ? "entry" : "entries"} in \`tools\`: ${entries.join(", ")}. A child's \`tools\` list is the complete set of tools it gets, so +name and -name entries are not supported; name every tool the child needs, or omit \`tools\` and use \`excludeTools\` to drop one.`);
1047
+ }
1048
+ function projectLaunchResolvedChildExtensions(toolPlan) {
1049
+ const runtime = boundedExtensionIdentifiers(toolPlan.runtimeExtensions);
1050
+ const configured = boundedExtensionIdentifiers(toolPlan.configuredExtensions);
1051
+ const effective = boundedExtensionIdentifiers(toolPlan.extensionArgs);
1052
+ return {
1053
+ version: 1,
1054
+ source: "launch-resolved",
1055
+ disableAmbientExtensions: toolPlan.disableAmbientExtensions,
1056
+ runtime: runtime.ids,
1057
+ configured: configured.ids,
1058
+ required: toolPlan.requiredExtensions.map(({ id }) => id),
1059
+ effective: effective.ids,
1060
+ omitted: {
1061
+ runtime: runtime.omitted,
1062
+ configured: configured.omitted,
1063
+ required: 0,
1064
+ effective: effective.omitted
1065
+ }
1066
+ };
1067
+ }
1068
+ function resolvePermissionSystemExtension() {
1069
+ const agentDir = getAgentDir();
1070
+ const candidates = [
1071
+ // Fork: the @xzzpig fork takes priority so child processes inherit the
1072
+ // same permission system the parent session loads from settings.json.
1073
+ // When only the upstream package is installed, behavior is unchanged.
1074
+ path5.join(
1075
+ agentDir,
1076
+ "npm",
1077
+ "node_modules",
1078
+ "@xzzpig",
1079
+ "pi-permission-system"
1080
+ ),
1081
+ // npm-scoped package (most common)
1082
+ path5.join(
1083
+ agentDir,
1084
+ "npm",
1085
+ "node_modules",
1086
+ "@gotgenes",
1087
+ "pi-permission-system"
1088
+ ),
1089
+ // direct extension directory (some layouts)
1090
+ path5.join(agentDir, "extensions", "pi-permission-system")
1091
+ ];
1092
+ const errors = [];
1093
+ for (const extDir of candidates) {
1094
+ if (!fs5.existsSync(extDir)) continue;
1095
+ const pkgPath = path5.join(extDir, "package.json");
1096
+ if (!fs5.existsSync(pkgPath)) {
1097
+ errors.push(new Error(`Permission-system package manifest is missing at ${pkgPath}.`));
1098
+ continue;
1099
+ }
1100
+ try {
1101
+ let pkg;
1102
+ const parsed = JSON.parse(fs5.readFileSync(pkgPath, "utf-8"));
1103
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
1104
+ throw new Error("manifest root must be an object");
1105
+ }
1106
+ pkg = parsed;
1107
+ const extensions = pkg.pi?.extensions;
1108
+ const entry = Array.isArray(extensions) ? extensions[0] : void 0;
1109
+ if (typeof entry !== "string" || !entry.trim()) {
1110
+ throw new Error(
1111
+ `Permission-system package manifest at ${pkgPath} must declare pi.extensions[0] as a non-empty string.`
1112
+ );
1113
+ }
1114
+ const resolved = path5.resolve(extDir, entry);
1115
+ if (fs5.existsSync(resolved)) return resolved;
1116
+ throw new Error(
1117
+ `Permission-system extension entry ${JSON.stringify(entry)} in ${pkgPath} does not exist at ${resolved}.`
1118
+ );
1119
+ } catch (error) {
1120
+ const message = error instanceof Error ? error.message : String(error);
1121
+ errors.push(message.startsWith("Permission-system") ? new Error(message) : new Error(`Cannot read permission-system package manifest at ${pkgPath}: ${message}`));
1122
+ }
1123
+ }
1124
+ if (errors.length > 0) throw errors[0];
1125
+ return void 0;
1126
+ }
1127
+ function resolvePiLaunchToolPlan(input) {
1128
+ const capabilityCeiling = intersectSubagentCapabilityCeilings(
1129
+ input.capabilityCeiling,
1130
+ input.inheritedCapabilityCeiling
1131
+ );
1132
+ const requiredExtensions = snapshotRequiredChildExtensions(input.requiredExtensions ?? []);
1133
+ if (requiredExtensions.length > 0 && capabilityCeiling?.denyExtensions) {
1134
+ throw new Error(`Capability ceiling from ${capabilityCeiling.sources.join(", ") || "unknown source"} denies extensions but this host requires: ${requiredExtensions.map(({ id }) => id).join(", ")}.`);
1135
+ }
1136
+ const allowedToolSet = capabilityCeiling?.allowedTools === void 0 ? void 0 : new Set(capabilityCeiling.allowedTools);
1137
+ const requestedBuiltinTools = input.tools?.filter((tool) => !isToolExtensionPath(tool)) ?? [];
1138
+ assertNoToolModifierEntries(input.agentName, input.tools ?? []);
1139
+ if (input.requireReadTool && allowedToolSet && !allowedToolSet.has("read")) {
1140
+ throw new Error(
1141
+ `Capability ceiling from ${capabilityCeiling?.sources.join(", ") || "unknown source"} excludes required tool 'read' for lazy skill loading.`
1142
+ );
1143
+ }
1144
+ const ceilingFilteredBuiltinTools = input.tools === void 0 ? allowedToolSet ? [...allowedToolSet].filter((tool) => tool !== "subagent_command") : [] : (input.requireReadTool && requestedBuiltinTools.length > 0 && !requestedBuiltinTools.includes("read") && !allowedToolSet ? ["read", ...requestedBuiltinTools] : requestedBuiltinTools).filter((tool) => !allowedToolSet || allowedToolSet.has(tool));
1145
+ const declaredBuiltinTools = ceilingFilteredBuiltinTools;
1146
+ const excludeTools = [...new Set((input.excludeTools ?? []).map((tool) => tool.trim()).filter(Boolean))];
1147
+ const excludedToolSet = new Set(excludeTools);
1148
+ const effectiveDeclaredBuiltinTools = declaredBuiltinTools.filter((tool) => !excludedToolSet.has(tool));
1149
+ const fanoutAuthorized = effectiveDeclaredBuiltinTools.includes("subagent") || input.allowNestedSubagents === true && !excludedToolSet.has("subagent") && (!allowedToolSet || allowedToolSet.has("subagent"));
1150
+ if (effectiveDeclaredBuiltinTools.includes("subagent_supervisor") && !fanoutAuthorized) {
1151
+ throw new Error("Tool 'subagent_supervisor' requires fanout authorization: include 'subagent' in the effective tools allowlist or enable allowNestedSubagents.");
1152
+ }
1153
+ const toolExtensionPaths = capabilityCeiling?.denyExtensions ? [] : (input.tools ?? []).filter(isToolExtensionPath);
1154
+ const mcpResolution = capabilityCeiling?.denyExtensions ? { selections: [], unresolvedSelectors: [] } : input.builtinMcpTools ? { selections: input.builtinMcpTools, unresolvedSelectors: [], builtin: true } : resolveMcpDirectToolResolution(input.mcpDirectTools, input.cwd, input.runtimeSnapshotHost);
1155
+ if (mcpResolution.runtimeServerNames?.length) {
1156
+ throw new Error(formatRuntimeSnapshotMcpServersError(input.agentName, mcpResolution.runtimeServerNames));
1157
+ }
1158
+ if (mcpResolution.unresolvedSelectors.length > 0) {
1159
+ throw new Error(mcpResolution.builtin ? formatUnresolvedBuiltinMcpSelectors(input.agentName, mcpResolution.unresolvedSelectors) : formatUnresolvedMcpDirectToolSelectors(mcpResolution.unresolvedSelectors));
1160
+ }
1161
+ const resolvedMcpSelections = mcpResolution.selections;
1162
+ const resolvedMcpNames = new Set(resolvedMcpSelections.map((selection) => selection.name));
1163
+ const legacyMcpNameCounts = mcpResolution.builtin ? /* @__PURE__ */ new Map() : countLegacyUnderscoreMcpToolNames(resolvedMcpSelections);
1164
+ const effectiveMcpSelections = resolvedMcpSelections.filter(
1165
+ (selection) => !allowedToolSet || allowedToolSet.has(selection.name) || isLegacyUnderscoreMcpToolAllowed(selection, allowedToolSet, resolvedMcpNames, legacyMcpNameCounts)
1166
+ ).filter((selection) => !excludedToolSet.has(selection.name));
1167
+ const effectiveMcpTools = effectiveMcpSelections.map(
1168
+ (selection) => selection.name
1169
+ );
1170
+ const builtinMcpTools = mcpResolution.builtin ? effectiveMcpSelections : void 0;
1171
+ const explicitToolAllowlist = input.tools !== void 0 || (input.mcpDirectTools?.length ?? 0) > 0 || allowedToolSet !== void 0;
1172
+ const internalTools = (input.structuredOutput ? ["structured_output"] : []).filter((tool) => !excludedToolSet.has(tool));
1173
+ const effectiveToolAllowlist = [
1174
+ .../* @__PURE__ */ new Set([
1175
+ ...effectiveDeclaredBuiltinTools,
1176
+ ...effectiveMcpTools,
1177
+ ...internalTools
1178
+ ])
1179
+ ];
1180
+ const legacySupervisorPairing = effectiveDeclaredBuiltinTools.includes("contact_supervisor");
1181
+ const requiredChildTools = explicitToolAllowlist ? [
1182
+ ...new Set([
1183
+ ...input.tools !== void 0 ? effectiveDeclaredBuiltinTools : [],
1184
+ ...input.mcpDirectTools?.length ? effectiveMcpTools : [],
1185
+ ...internalTools
1186
+ ].filter((tool) => tool !== "contact_supervisor" && (!legacySupervisorPairing || tool !== "intercom")))
1187
+ ] : [];
1188
+ const permSystemExt = capabilityCeiling?.denyExtensions ? void 0 : hasPermissionRules(input.permissionRules) ? resolvePermissionSystemExtension() : void 0;
1189
+ const { sandboxExtension, effectivePermSystemExt } = resolveProfileExtensions({
1190
+ sandbox: input.sandbox,
1191
+ permissionProfile: input.permissionProfile,
1192
+ capabilityCeiling,
1193
+ permSystemExt
1194
+ });
1195
+ if (input.fast && capabilityCeiling?.denyExtensions) throw new Error("fast mode requires a child runtime extension, but this launch denies extensions.");
1196
+ const fastModeExtensions = resolveFastModeExtension({ fast: input.fast, model: input.model, agentName: input.agentName });
1197
+ const runtimeExtensions = [
1198
+ resolveRuntimeModulePath(RUNTIME_EXTENSION_DIR, "subagent-prompt-runtime"),
1199
+ ...fastModeExtensions,
1200
+ ...fanoutAuthorized ? [resolveRuntimeModulePath(FANOUT_CHILD_EXTENSION_DIR, "fanout-child")] : [],
1201
+ ...effectivePermSystemExt ? [effectivePermSystemExt] : [],
1202
+ ...sandboxExtension ? [sandboxExtension, SANDBOX_PROFILE_GUARD_EXTENSION_PATH] : []
1203
+ ];
1204
+ const disableAmbientExtensions = capabilityCeiling?.denyExtensions === true || input.extensions !== void 0;
1205
+ const warnings = [];
1206
+ if (capabilityCeiling?.denyExtensions !== true && Array.isArray(input.extensions) && input.extensions.length === 0) {
1207
+ const agentLabel = input.agentName ? ` for agent '${input.agentName}'` : "";
1208
+ warnings.push(
1209
+ `extensions: [] override${agentLabel} disables ALL ambient extensions for this child (not just "adds nothing"), including any model-provider extension needed to resolve a provider-qualified model. List the extensions this child actually needs instead of an empty array.`
1210
+ );
1211
+ }
1212
+ const configuredExtensions = capabilityCeiling?.denyExtensions ? [] : [
1213
+ ...toolExtensionPaths,
1214
+ ...input.extensions ?? [],
1215
+ ...input.subagentOnlyExtensions ?? []
1216
+ ];
1217
+ const ordinaryExtensionArgs = disableAmbientExtensions ? [.../* @__PURE__ */ new Set([...runtimeExtensions, ...configuredExtensions])] : [
1218
+ .../* @__PURE__ */ new Set([
1219
+ ...runtimeExtensions,
1220
+ ...toolExtensionPaths,
1221
+ ...input.subagentOnlyExtensions ?? []
1222
+ ])
1223
+ ];
1224
+ const extensionArgs = [.../* @__PURE__ */ new Set([...ordinaryExtensionArgs, ...requiredExtensions.map(({ path: path6 }) => path6)])];
1225
+ const requestedToolNames = input.tools !== void 0 ? [
1226
+ .../* @__PURE__ */ new Set([
1227
+ ...requestedBuiltinTools,
1228
+ ...resolvedMcpSelections.map((selection) => selection.name)
1229
+ ])
1230
+ ] : void 0;
1231
+ const capabilityAudit = capabilityCeiling ? {
1232
+ ceiling: capabilityCeiling,
1233
+ ...requestedToolNames ? { requestedTools: requestedToolNames } : {},
1234
+ effectiveTools: effectiveToolAllowlist,
1235
+ ...excludeTools.length > 0 ? { excludeTools } : {},
1236
+ removedTools: requestedToolNames?.filter(
1237
+ (tool) => !effectiveToolAllowlist.includes(tool)
1238
+ ) ?? [],
1239
+ internalTools,
1240
+ extensionsDenied: capabilityCeiling.denyExtensions,
1241
+ removedExtensionCount: capabilityCeiling.denyExtensions ? (input.extensions?.length ?? 0) + (input.subagentOnlyExtensions?.length ?? 0) + (input.tools ?? []).filter(isToolExtensionPath).length : 0,
1242
+ requestedMcpToolCount: input.mcpDirectTools?.length ?? 0,
1243
+ effectiveMcpTools,
1244
+ agentAllowed: input.agentName === void 0 ? true : isAgentAllowedByCapabilityCeiling(
1245
+ input.agentName,
1246
+ capabilityCeiling
1247
+ ),
1248
+ ...capabilityCeilingAgentRestrictionSources(capabilityCeiling) ? {
1249
+ agentRestrictionSources: capabilityCeilingAgentRestrictionSources(capabilityCeiling)
1250
+ } : {}
1251
+ } : void 0;
1252
+ return {
1253
+ ...capabilityCeiling ? { capabilityCeiling } : {},
1254
+ requestedBuiltinTools,
1255
+ declaredBuiltinTools,
1256
+ excludeTools,
1257
+ toolExtensionPaths,
1258
+ resolvedMcpSelections,
1259
+ effectiveMcpSelections,
1260
+ effectiveMcpTools,
1261
+ builtinMcpTools,
1262
+ explicitToolAllowlist,
1263
+ internalTools,
1264
+ effectiveToolAllowlist,
1265
+ requiredChildTools,
1266
+ fanoutAuthorized,
1267
+ ...sandboxExtension ? { sandboxExtension } : {},
1268
+ runtimeExtensions,
1269
+ configuredExtensions,
1270
+ requiredExtensions,
1271
+ extensionArgs,
1272
+ disableAmbientExtensions,
1273
+ warnings,
1274
+ ...capabilityAudit ? { capabilityAudit } : {}
1275
+ };
1276
+ }
1277
+ function countLegacyUnderscoreMcpToolNames(selections) {
1278
+ const counts = /* @__PURE__ */ new Map();
1279
+ for (const selection of selections) {
1280
+ const legacyName = legacyUnderscoreMcpToolName(selection);
1281
+ if (legacyName !== selection.name) counts.set(legacyName, (counts.get(legacyName) ?? 0) + 1);
1282
+ }
1283
+ return counts;
1284
+ }
1285
+ function isLegacyUnderscoreMcpToolAllowed(selection, allowedToolSet, resolvedMcpNames, legacyMcpNameCounts) {
1286
+ const legacyName = legacyUnderscoreMcpToolName(selection);
1287
+ return legacyMcpNameCounts.get(legacyName) === 1 && !resolvedMcpNames.has(legacyName) && allowedToolSet.has(legacyName);
1288
+ }
1289
+ function legacyUnderscoreMcpToolName(selection) {
1290
+ const slash = selection.selector.indexOf("/");
1291
+ if (slash < 1) return selection.name;
1292
+ const toolName = selection.selector.slice(slash + 1);
1293
+ const suffix = `_${toolName}`;
1294
+ if (!selection.name.endsWith(suffix)) return selection.name;
1295
+ const prefix = selection.name.slice(0, -suffix.length);
1296
+ return `${prefix.replace(/-/g, "_")}${suffix}`;
1297
+ }
1298
+ function getHostBuiltinToolNames(pi) {
1299
+ try {
1300
+ const builtins = pi.getAllTools().filter((tool) => {
1301
+ const source = tool.sourceInfo?.source;
1302
+ return source === "builtin" || PI_BUILTIN_TOOL_NAMES.has(tool.name);
1303
+ }).map((tool) => tool.name);
1304
+ return builtins.length > 0 ? builtins : void 0;
1305
+ } catch {
1306
+ return void 0;
1307
+ }
1308
+ }
1309
+
1310
+ export {
1311
+ extensionOnlyMcpServers,
1312
+ resolveRuntimeModulePath,
1313
+ isSubagentRuntimeExtensionPath,
1314
+ deriveForkPromptCacheKey,
1315
+ supervisorChannelDir,
1316
+ applyThinkingSuffix,
1317
+ assertNoToolModifierEntries,
1318
+ projectLaunchResolvedChildExtensions,
1319
+ resolvePiLaunchToolPlan,
1320
+ getHostBuiltinToolNames
1321
+ };