@xzzpig/pi-subagents 0.21.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1132) hide show
  1. package/CHANGELOG.md +356 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/fork-supervisor-routing.md +77 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -86
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1288 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/inspectors/actions.d.ts +24 -0
  196. package/src/inspectors/actions.js +182 -0
  197. package/src/inspectors/ghostty/actions.d.ts +11 -0
  198. package/src/inspectors/ghostty/actions.js +62 -0
  199. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  200. package/src/inspectors/ghostty/plugin.js +23 -0
  201. package/src/inspectors/herdr/actions.d.ts +25 -0
  202. package/src/inspectors/herdr/actions.js +133 -0
  203. package/src/inspectors/herdr/client.d.ts +41 -0
  204. package/src/inspectors/herdr/client.js +129 -0
  205. package/src/inspectors/herdr/focus.d.ts +24 -0
  206. package/src/inspectors/herdr/focus.js +49 -0
  207. package/src/inspectors/herdr/plugin.d.ts +6 -0
  208. package/src/inspectors/herdr/plugin.js +14 -0
  209. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  210. package/src/inspectors/herdr/project-panes.js +610 -0
  211. package/src/inspectors/inspector-runner.d.ts +23 -0
  212. package/src/inspectors/inspector-runner.js +161 -0
  213. package/src/inspectors/plugins.d.ts +8 -0
  214. package/src/inspectors/plugins.js +82 -0
  215. package/src/inspectors/session-roots-codec.d.ts +15 -0
  216. package/src/inspectors/session-roots-codec.js +32 -0
  217. package/src/inspectors/shell-command.d.ts +1 -0
  218. package/src/inspectors/shell-command.js +16 -0
  219. package/src/inspectors/tmux/actions.d.ts +25 -0
  220. package/src/inspectors/tmux/actions.js +181 -0
  221. package/src/inspectors/tmux/client.d.ts +27 -0
  222. package/src/inspectors/tmux/client.js +64 -0
  223. package/src/inspectors/tmux/plugin.d.ts +7 -0
  224. package/src/inspectors/tmux/plugin.js +14 -0
  225. package/src/inspectors/types.d.ts +48 -0
  226. package/src/inspectors/types.js +1 -0
  227. package/src/integrations/herdr-status.d.ts +47 -0
  228. package/src/integrations/herdr-status.js +350 -0
  229. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  230. package/src/integrations/pi-web-session-liveness.js +53 -0
  231. package/src/integrations/program-status.d.ts +30 -0
  232. package/src/integrations/program-status.js +188 -0
  233. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  234. package/src/intercom/fork-supervisor-routing.js +392 -0
  235. package/src/intercom/intercom-bridge.d.ts +58 -0
  236. package/src/intercom/intercom-bridge.js +193 -0
  237. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  238. package/src/intercom/native-supervisor-channel.js +1184 -0
  239. package/src/intercom/result-intercom.d.ts +35 -0
  240. package/src/intercom/result-intercom.js +376 -0
  241. package/src/intercom/supervisor-ui.d.ts +29 -0
  242. package/src/intercom/supervisor-ui.js +49 -0
  243. package/src/missions/actions.d.ts +54 -0
  244. package/src/missions/actions.js +400 -0
  245. package/src/missions/goal-driver.d.ts +16 -0
  246. package/src/missions/goal-driver.js +171 -0
  247. package/src/missions/lifecycle.d.ts +50 -0
  248. package/src/missions/lifecycle.js +388 -0
  249. package/src/missions/store.d.ts +21 -0
  250. package/src/missions/store.js +605 -0
  251. package/src/missions/types.d.ts +169 -0
  252. package/src/missions/types.js +9 -0
  253. package/src/missions/workflow-state.d.ts +14 -0
  254. package/src/missions/workflow-state.js +273 -0
  255. package/src/policy/authority.d.ts +9 -0
  256. package/src/policy/authority.js +41 -0
  257. package/src/profiles/profiles.d.ts +134 -0
  258. package/src/profiles/profiles.js +526 -0
  259. package/src/runs/background/active-async-capacity.d.ts +115 -0
  260. package/src/runs/background/active-async-capacity.js +517 -0
  261. package/src/runs/background/active-run-index.d.ts +12 -0
  262. package/src/runs/background/active-run-index.js +157 -0
  263. package/src/runs/background/async-execution.d.ts +304 -0
  264. package/src/runs/background/async-execution.js +2206 -0
  265. package/src/runs/background/async-job-tracker.d.ts +37 -0
  266. package/src/runs/background/async-job-tracker.js +921 -0
  267. package/src/runs/background/async-resume.d.ts +60 -0
  268. package/src/runs/background/async-resume.js +707 -0
  269. package/src/runs/background/async-retention.d.ts +45 -0
  270. package/src/runs/background/async-retention.js +932 -0
  271. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  272. package/src/runs/background/async-status-snapshot.js +26 -0
  273. package/src/runs/background/async-status.d.ts +177 -0
  274. package/src/runs/background/async-status.js +710 -0
  275. package/src/runs/background/auto-drain.d.ts +16 -0
  276. package/src/runs/background/auto-drain.js +71 -0
  277. package/src/runs/background/await-async-run.d.ts +26 -0
  278. package/src/runs/background/await-async-run.js +83 -0
  279. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  280. package/src/runs/background/binary-bootstrap.js +69 -0
  281. package/src/runs/background/boot-id.d.ts +12 -0
  282. package/src/runs/background/boot-id.js +47 -0
  283. package/src/runs/background/calendar-schedule.d.ts +26 -0
  284. package/src/runs/background/calendar-schedule.js +93 -0
  285. package/src/runs/background/chain-append.d.ts +34 -0
  286. package/src/runs/background/chain-append.js +299 -0
  287. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  288. package/src/runs/background/chain-root-attachment.js +186 -0
  289. package/src/runs/background/completion-batcher.d.ts +51 -0
  290. package/src/runs/background/completion-batcher.js +119 -0
  291. package/src/runs/background/completion-dedupe.d.ts +13 -0
  292. package/src/runs/background/completion-dedupe.js +48 -0
  293. package/src/runs/background/completion-replay.d.ts +47 -0
  294. package/src/runs/background/completion-replay.js +266 -0
  295. package/src/runs/background/control-channel.d.ts +170 -0
  296. package/src/runs/background/control-channel.js +610 -0
  297. package/src/runs/background/fleet-view.d.ts +63 -0
  298. package/src/runs/background/fleet-view.js +666 -0
  299. package/src/runs/background/index-segment.d.ts +16 -0
  300. package/src/runs/background/index-segment.js +58 -0
  301. package/src/runs/background/inspect-rpc.d.ts +64 -0
  302. package/src/runs/background/inspect-rpc.js +422 -0
  303. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  304. package/src/runs/background/interrupted-elsewhere.js +68 -0
  305. package/src/runs/background/notify.d.ts +214 -0
  306. package/src/runs/background/notify.js +1001 -0
  307. package/src/runs/background/owned-process-tree.d.ts +10 -0
  308. package/src/runs/background/owned-process-tree.js +116 -0
  309. package/src/runs/background/parallel-groups.d.ts +3 -0
  310. package/src/runs/background/parallel-groups.js +46 -0
  311. package/src/runs/background/pid-namespace.d.ts +2 -0
  312. package/src/runs/background/pid-namespace.js +19 -0
  313. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  314. package/src/runs/background/process-terminal-candidate.js +96 -0
  315. package/src/runs/background/process-terminal.d.ts +21 -0
  316. package/src/runs/background/process-terminal.js +227 -0
  317. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  318. package/src/runs/background/result-delivery-ownership.js +38 -0
  319. package/src/runs/background/result-files.d.ts +63 -0
  320. package/src/runs/background/result-files.js +629 -0
  321. package/src/runs/background/result-watcher.d.ts +92 -0
  322. package/src/runs/background/result-watcher.js +819 -0
  323. package/src/runs/background/resume-guidance.d.ts +4 -0
  324. package/src/runs/background/resume-guidance.js +57 -0
  325. package/src/runs/background/retained-children.d.ts +24 -0
  326. package/src/runs/background/retained-children.js +128 -0
  327. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  328. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  329. package/src/runs/background/run-child-session.d.ts +123 -0
  330. package/src/runs/background/run-child-session.js +670 -0
  331. package/src/runs/background/run-id-query.d.ts +3 -0
  332. package/src/runs/background/run-id-query.js +6 -0
  333. package/src/runs/background/run-id-resolver.d.ts +22 -0
  334. package/src/runs/background/run-id-resolver.js +172 -0
  335. package/src/runs/background/run-status.d.ts +25 -0
  336. package/src/runs/background/run-status.js +850 -0
  337. package/src/runs/background/runner-aliases.d.ts +17 -0
  338. package/src/runs/background/runner-aliases.js +191 -0
  339. package/src/runs/background/runner-child-launch.d.ts +24 -0
  340. package/src/runs/background/runner-child-launch.js +72 -0
  341. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  342. package/src/runs/background/runner-child-sessions.js +34 -0
  343. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  344. package/src/runs/background/runner-http-dispatcher.js +115 -0
  345. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  346. package/src/runs/background/runner-startup-failure.js +46 -0
  347. package/src/runs/background/scheduled-runs.d.ts +127 -0
  348. package/src/runs/background/scheduled-runs.js +1265 -0
  349. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  350. package/src/runs/background/stale-run-reconciler.js +509 -0
  351. package/src/runs/background/steering.d.ts +51 -0
  352. package/src/runs/background/steering.js +246 -0
  353. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  354. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  355. package/src/runs/background/subagent-runner.d.ts +210 -0
  356. package/src/runs/background/subagent-runner.js +4963 -0
  357. package/src/runs/background/subagent-wait.d.ts +124 -0
  358. package/src/runs/background/subagent-wait.js +756 -0
  359. package/src/runs/background/terminal-run-index.d.ts +10 -0
  360. package/src/runs/background/terminal-run-index.js +209 -0
  361. package/src/runs/background/top-level-async.d.ts +7 -0
  362. package/src/runs/background/top-level-async.js +5 -0
  363. package/src/runs/background/wait-completions.d.ts +28 -0
  364. package/src/runs/background/wait-completions.js +264 -0
  365. package/src/runs/background/wait-config.d.ts +8 -0
  366. package/src/runs/background/wait-config.js +46 -0
  367. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  368. package/src/runs/background/wait-subscriptions.js +339 -0
  369. package/src/runs/background/wait-tool.d.ts +6 -0
  370. package/src/runs/background/wait-tool.js +48 -0
  371. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  372. package/src/runs/background/workflow-terminal-proof.js +116 -0
  373. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  374. package/src/runs/foreground/async-dismiss-action.js +82 -0
  375. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  376. package/src/runs/foreground/async-steering-action.js +294 -0
  377. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  378. package/src/runs/foreground/async-stop-action.js +213 -0
  379. package/src/runs/foreground/command-action.d.ts +12 -0
  380. package/src/runs/foreground/command-action.js +38 -0
  381. package/src/runs/foreground/execution.d.ts +10 -0
  382. package/src/runs/foreground/execution.js +2322 -0
  383. package/src/runs/foreground/foreground-control.d.ts +24 -0
  384. package/src/runs/foreground/foreground-control.js +138 -0
  385. package/src/runs/foreground/foreground-history.d.ts +25 -0
  386. package/src/runs/foreground/foreground-history.js +267 -0
  387. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  388. package/src/runs/foreground/prompt-audit.js +138 -0
  389. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  390. package/src/runs/foreground/subagent-executor.js +7986 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  392. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  393. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  394. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  395. package/src/runs/shared/abort-recovery.d.ts +26 -0
  396. package/src/runs/shared/abort-recovery.js +108 -0
  397. package/src/runs/shared/acceptance.d.ts +144 -0
  398. package/src/runs/shared/acceptance.js +1616 -0
  399. package/src/runs/shared/agent-contract.d.ts +5 -0
  400. package/src/runs/shared/agent-contract.js +35 -0
  401. package/src/runs/shared/async-status-projection.d.ts +100 -0
  402. package/src/runs/shared/async-status-projection.js +566 -0
  403. package/src/runs/shared/background-process-options.d.ts +4 -0
  404. package/src/runs/shared/background-process-options.js +6 -0
  405. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  406. package/src/runs/shared/capability-ceiling.js +179 -0
  407. package/src/runs/shared/chain-outputs.d.ts +18 -0
  408. package/src/runs/shared/chain-outputs.js +104 -0
  409. package/src/runs/shared/child-commands.d.ts +29 -0
  410. package/src/runs/shared/child-commands.js +254 -0
  411. package/src/runs/shared/child-hooks.d.ts +31 -0
  412. package/src/runs/shared/child-hooks.js +173 -0
  413. package/src/runs/shared/child-identity.d.ts +23 -0
  414. package/src/runs/shared/child-identity.js +40 -0
  415. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  416. package/src/runs/shared/child-launch-plan.js +88 -0
  417. package/src/runs/shared/child-launch.d.ts +128 -0
  418. package/src/runs/shared/child-launch.js +262 -0
  419. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  420. package/src/runs/shared/child-lifecycle.js +22 -0
  421. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  422. package/src/runs/shared/child-runtime-config.js +44 -0
  423. package/src/runs/shared/child-session.d.ts +178 -0
  424. package/src/runs/shared/child-session.js +726 -0
  425. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  426. package/src/runs/shared/child-tool-plan.js +430 -0
  427. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  428. package/src/runs/shared/claude-code-adapter.js +255 -0
  429. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  430. package/src/runs/shared/codex-exec-adapter.js +127 -0
  431. package/src/runs/shared/context-mode.d.ts +12 -0
  432. package/src/runs/shared/context-mode.js +38 -0
  433. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  434. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  435. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  436. package/src/runs/shared/dynamic-fanout.js +273 -0
  437. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  438. package/src/runs/shared/effective-system-prompt.js +23 -0
  439. package/src/runs/shared/extension-bindings.d.ts +25 -0
  440. package/src/runs/shared/extension-bindings.js +96 -0
  441. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  442. package/src/runs/shared/external-cli-contract.js +145 -0
  443. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  444. package/src/runs/shared/external-cli-preflight.js +159 -0
  445. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  446. package/src/runs/shared/external-cli-runner.js +425 -0
  447. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  448. package/src/runs/shared/external-job-bridge.js +486 -0
  449. package/src/runs/shared/external-job-runner.d.ts +44 -0
  450. package/src/runs/shared/external-job-runner.js +352 -0
  451. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  452. package/src/runs/shared/fast-mode-extension.js +8 -0
  453. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  454. package/src/runs/shared/fork-placed-env.js +13 -0
  455. package/src/runs/shared/git-environment.d.ts +2 -0
  456. package/src/runs/shared/git-environment.js +27 -0
  457. package/src/runs/shared/herdr-connection.d.ts +79 -0
  458. package/src/runs/shared/herdr-connection.js +269 -0
  459. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  460. package/src/runs/shared/herdr-external-adapters.js +404 -0
  461. package/src/runs/shared/herdr-machine.d.ts +59 -0
  462. package/src/runs/shared/herdr-machine.js +294 -0
  463. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  464. package/src/runs/shared/herdr-pane-host.js +155 -0
  465. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  466. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  467. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  468. package/src/runs/shared/herdr-placed-run.js +380 -0
  469. package/src/runs/shared/host-step-status.d.ts +33 -0
  470. package/src/runs/shared/host-step-status.js +244 -0
  471. package/src/runs/shared/lane-metadata.d.ts +23 -0
  472. package/src/runs/shared/lane-metadata.js +126 -0
  473. package/src/runs/shared/launch-cwd.d.ts +1 -0
  474. package/src/runs/shared/launch-cwd.js +16 -0
  475. package/src/runs/shared/local-machine-access.d.ts +5 -0
  476. package/src/runs/shared/local-machine-access.js +28 -0
  477. package/src/runs/shared/long-running-guard.d.ts +34 -0
  478. package/src/runs/shared/long-running-guard.js +256 -0
  479. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  480. package/src/runs/shared/mcp-config-sources.js +418 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  482. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  484. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  485. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  486. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  487. package/src/runs/shared/model-resolution.d.ts +109 -0
  488. package/src/runs/shared/model-resolution.js +411 -0
  489. package/src/runs/shared/model-scope.d.ts +68 -0
  490. package/src/runs/shared/model-scope.js +171 -0
  491. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  492. package/src/runs/shared/mutation-evidence.js +198 -0
  493. package/src/runs/shared/nested-events.d.ts +135 -0
  494. package/src/runs/shared/nested-events.js +1090 -0
  495. package/src/runs/shared/nested-path.d.ts +8 -0
  496. package/src/runs/shared/nested-path.js +34 -0
  497. package/src/runs/shared/nested-render.d.ts +20 -0
  498. package/src/runs/shared/nested-render.js +115 -0
  499. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  500. package/src/runs/shared/orca-progress-tabs.js +503 -0
  501. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  502. package/src/runs/shared/parallel-handoff.js +783 -0
  503. package/src/runs/shared/parallel-utils.d.ts +177 -0
  504. package/src/runs/shared/parallel-utils.js +125 -0
  505. package/src/runs/shared/partial-output.d.ts +24 -0
  506. package/src/runs/shared/partial-output.js +35 -0
  507. package/src/runs/shared/permissions.d.ts +12 -0
  508. package/src/runs/shared/permissions.js +92 -0
  509. package/src/runs/shared/pi-spawn.d.ts +31 -0
  510. package/src/runs/shared/pi-spawn.js +211 -0
  511. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  512. package/src/runs/shared/placed-run-owner.js +93 -0
  513. package/src/runs/shared/placement-host.d.ts +99 -0
  514. package/src/runs/shared/placement-host.js +157 -0
  515. package/src/runs/shared/process-signal.d.ts +15 -0
  516. package/src/runs/shared/process-signal.js +21 -0
  517. package/src/runs/shared/profile-extensions.d.ts +21 -0
  518. package/src/runs/shared/profile-extensions.js +122 -0
  519. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  520. package/src/runs/shared/profile-launch-env.js +90 -0
  521. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  522. package/src/runs/shared/readonly-drain-observation.js +50 -0
  523. package/src/runs/shared/rex-machine.d.ts +25 -0
  524. package/src/runs/shared/rex-machine.js +83 -0
  525. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  526. package/src/runs/shared/rex-pane-host.js +327 -0
  527. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  528. package/src/runs/shared/run-fanout-budget.js +258 -0
  529. package/src/runs/shared/run-ownership.d.ts +3 -0
  530. package/src/runs/shared/run-ownership.js +8 -0
  531. package/src/runs/shared/runner-launcher.d.ts +11 -0
  532. package/src/runs/shared/runner-launcher.js +24 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  534. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  535. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  536. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  538. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  539. package/src/runs/shared/session-lease.d.ts +69 -0
  540. package/src/runs/shared/session-lease.js +250 -0
  541. package/src/runs/shared/single-output.d.ts +90 -0
  542. package/src/runs/shared/single-output.js +349 -0
  543. package/src/runs/shared/spawn-budget.d.ts +20 -0
  544. package/src/runs/shared/spawn-budget.js +93 -0
  545. package/src/runs/shared/structured-output.d.ts +66 -0
  546. package/src/runs/shared/structured-output.js +483 -0
  547. package/src/runs/shared/subagent-control.d.ts +50 -0
  548. package/src/runs/shared/subagent-control.js +247 -0
  549. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  550. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  551. package/src/runs/shared/tool-availability.d.ts +16 -0
  552. package/src/runs/shared/tool-availability.js +29 -0
  553. package/src/runs/shared/tool-budget.d.ts +21 -0
  554. package/src/runs/shared/tool-budget.js +78 -0
  555. package/src/runs/shared/tool-timeout.d.ts +31 -0
  556. package/src/runs/shared/tool-timeout.js +73 -0
  557. package/src/runs/shared/usage-budget.d.ts +7 -0
  558. package/src/runs/shared/usage-budget.js +74 -0
  559. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  560. package/src/runs/shared/usage-reconciliation.js +71 -0
  561. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  562. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  563. package/src/runs/shared/workflow-graph.d.ts +31 -0
  564. package/src/runs/shared/workflow-graph.js +221 -0
  565. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  566. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  567. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  568. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  569. package/src/runs/shared/worktree-lock.d.ts +5 -0
  570. package/src/runs/shared/worktree-lock.js +40 -0
  571. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  572. package/src/runs/shared/worktree-setup-command.js +200 -0
  573. package/src/runs/shared/worktree.d.ts +181 -0
  574. package/src/runs/shared/worktree.js +1346 -0
  575. package/src/shared/accessible-dir.d.ts +11 -0
  576. package/src/shared/accessible-dir.js +39 -0
  577. package/src/shared/agent-stream-options.d.ts +5 -0
  578. package/src/shared/agent-stream-options.js +3 -0
  579. package/src/shared/artifacts.d.ts +22 -0
  580. package/src/shared/artifacts.js +272 -0
  581. package/src/shared/atomic-json.d.ts +19 -0
  582. package/src/shared/atomic-json.js +61 -0
  583. package/src/shared/capacity-resilient-json.d.ts +26 -0
  584. package/src/shared/capacity-resilient-json.js +86 -0
  585. package/src/shared/child-cache-retention.d.ts +29 -0
  586. package/src/shared/child-cache-retention.js +40 -0
  587. package/src/shared/child-session-name.d.ts +8 -0
  588. package/src/shared/child-session-name.js +40 -0
  589. package/src/shared/child-transcript.d.ts +37 -0
  590. package/src/shared/child-transcript.js +225 -0
  591. package/src/shared/completion-owner.d.ts +7 -0
  592. package/src/shared/completion-owner.js +13 -0
  593. package/src/shared/disabled-features.d.ts +93 -0
  594. package/src/shared/disabled-features.js +120 -0
  595. package/src/shared/display-text.d.ts +5 -0
  596. package/src/shared/display-text.js +154 -0
  597. package/src/shared/edit-distance.d.ts +4 -0
  598. package/src/shared/edit-distance.js +32 -0
  599. package/src/shared/extension-context.d.ts +21 -0
  600. package/src/shared/extension-context.js +39 -0
  601. package/src/shared/file-coalescer.d.ts +11 -0
  602. package/src/shared/file-coalescer.js +34 -0
  603. package/src/shared/file-lease.d.ts +10 -0
  604. package/src/shared/file-lease.js +106 -0
  605. package/src/shared/file-system-retry.d.ts +31 -0
  606. package/src/shared/file-system-retry.js +84 -0
  607. package/src/shared/fork-context.d.ts +64 -0
  608. package/src/shared/fork-context.js +185 -0
  609. package/src/shared/fork-session-cwd.d.ts +2 -0
  610. package/src/shared/fork-session-cwd.js +23 -0
  611. package/src/shared/formatters.d.ts +35 -0
  612. package/src/shared/formatters.js +137 -0
  613. package/src/shared/jsonl-writer.d.ts +20 -0
  614. package/src/shared/jsonl-writer.js +67 -0
  615. package/src/shared/launch-contract.d.ts +65 -0
  616. package/src/shared/launch-contract.js +145 -0
  617. package/src/shared/model-info.d.ts +55 -0
  618. package/src/shared/model-info.js +103 -0
  619. package/src/shared/model-response-aliases.d.ts +1 -0
  620. package/src/shared/model-response-aliases.js +15 -0
  621. package/src/shared/node-executable.d.ts +1 -0
  622. package/src/shared/node-executable.js +20 -0
  623. package/src/shared/opencode-session-headers.d.ts +12 -0
  624. package/src/shared/opencode-session-headers.js +26 -0
  625. package/src/shared/package-version.d.ts +2 -0
  626. package/src/shared/package-version.js +14 -0
  627. package/src/shared/parent-wake.d.ts +26 -0
  628. package/src/shared/parent-wake.js +68 -0
  629. package/src/shared/permission-profile.d.ts +26 -0
  630. package/src/shared/permission-profile.js +49 -0
  631. package/src/shared/prompt-resources.d.ts +5 -0
  632. package/src/shared/prompt-resources.js +10 -0
  633. package/src/shared/provider-diagnostics.d.ts +9 -0
  634. package/src/shared/provider-diagnostics.js +75 -0
  635. package/src/shared/pruned-fork.d.ts +34 -0
  636. package/src/shared/pruned-fork.js +434 -0
  637. package/src/shared/required-child-extensions.d.ts +34 -0
  638. package/src/shared/required-child-extensions.js +105 -0
  639. package/src/shared/runtime-module-path.d.ts +10 -0
  640. package/src/shared/runtime-module-path.js +16 -0
  641. package/src/shared/sandbox-profile.d.ts +12 -0
  642. package/src/shared/sandbox-profile.js +35 -0
  643. package/src/shared/session-file-trust.d.ts +1 -0
  644. package/src/shared/session-file-trust.js +20 -0
  645. package/src/shared/session-identity.d.ts +8 -0
  646. package/src/shared/session-identity.js +32 -0
  647. package/src/shared/session-succession.d.ts +4 -0
  648. package/src/shared/session-succession.js +24 -0
  649. package/src/shared/session-tokens.d.ts +2 -0
  650. package/src/shared/session-tokens.js +58 -0
  651. package/src/shared/settings-file-lease.d.ts +4 -0
  652. package/src/shared/settings-file-lease.js +38 -0
  653. package/src/shared/settings.d.ts +146 -0
  654. package/src/shared/settings.js +247 -0
  655. package/src/shared/shortcuts.d.ts +1 -0
  656. package/src/shared/shortcuts.js +17 -0
  657. package/src/shared/status-format.d.ts +9 -0
  658. package/src/shared/status-format.js +60 -0
  659. package/src/shared/thinking-ceiling.d.ts +13 -0
  660. package/src/shared/thinking-ceiling.js +37 -0
  661. package/src/shared/types.d.ts +2840 -0
  662. package/src/shared/types.js +276 -0
  663. package/src/shared/utf8.d.ts +5 -0
  664. package/src/shared/utf8.js +12 -0
  665. package/src/shared/utils.d.ts +83 -0
  666. package/src/shared/utils.js +612 -0
  667. package/src/shared/watch-strategy.d.ts +2 -0
  668. package/src/shared/watch-strategy.js +5 -0
  669. package/src/shared/workflow-child-permit.d.ts +58 -0
  670. package/src/shared/workflow-child-permit.js +159 -0
  671. package/src/slash/delegation-adapters.d.ts +154 -0
  672. package/src/slash/delegation-adapters.js +316 -0
  673. package/src/slash/delegation-json.d.ts +10 -0
  674. package/src/slash/delegation-json.js +117 -0
  675. package/src/slash/delegation-request.d.ts +12 -0
  676. package/src/slash/delegation-request.js +174 -0
  677. package/src/slash/prompt-template-bridge.d.ts +29 -0
  678. package/src/slash/prompt-template-bridge.js +399 -0
  679. package/src/slash/prompt-workflows.d.ts +21 -0
  680. package/src/slash/prompt-workflows.js +274 -0
  681. package/src/slash/selector.d.ts +47 -0
  682. package/src/slash/selector.js +117 -0
  683. package/src/slash/slash-bridge.d.ts +30 -0
  684. package/src/slash/slash-bridge.js +132 -0
  685. package/src/slash/slash-commands.d.ts +10 -0
  686. package/src/slash/slash-commands.js +1059 -0
  687. package/src/slash/slash-live-state.d.ts +21 -0
  688. package/src/slash/slash-live-state.js +263 -0
  689. package/src/slash/subagent-cost.d.ts +29 -0
  690. package/src/slash/subagent-cost.js +310 -0
  691. package/src/slash/subagents-admin.d.ts +3 -0
  692. package/src/slash/subagents-admin.js +481 -0
  693. package/src/tui/fleet-layout.d.ts +20 -0
  694. package/src/tui/fleet-layout.js +17 -0
  695. package/src/tui/fleet-native-transcript.d.ts +53 -0
  696. package/src/tui/fleet-native-transcript.js +339 -0
  697. package/src/tui/fleet-status.d.ts +92 -0
  698. package/src/tui/fleet-status.js +1132 -0
  699. package/src/tui/fleet-transcript.d.ts +64 -0
  700. package/src/tui/fleet-transcript.js +544 -0
  701. package/src/tui/fleet-viewport.d.ts +12 -0
  702. package/src/tui/fleet-viewport.js +35 -0
  703. package/src/tui/fleet.d.ts +196 -0
  704. package/src/tui/fleet.js +1588 -0
  705. package/src/tui/mouse-events.d.ts +21 -0
  706. package/src/tui/mouse-events.js +26 -0
  707. package/src/tui/render-helpers.d.ts +23 -0
  708. package/src/tui/render-helpers.js +100 -0
  709. package/src/tui/render.d.ts +66 -0
  710. package/src/tui/render.js +3707 -0
  711. package/src/tui/running-tone.d.ts +10 -0
  712. package/src/tui/running-tone.js +22 -0
  713. package/src/tui/subagent-messages.d.ts +22 -0
  714. package/src/tui/subagent-messages.js +270 -0
  715. package/src/ui-silent-marker.d.ts +20 -0
  716. package/src/ui-silent-marker.js +25 -0
  717. package/src/watchdog/change-signature.d.ts +7 -0
  718. package/src/watchdog/change-signature.js +243 -0
  719. package/src/watchdog/child-status.d.ts +53 -0
  720. package/src/watchdog/child-status.js +187 -0
  721. package/src/watchdog/diff-tool.d.ts +25 -0
  722. package/src/watchdog/diff-tool.js +104 -0
  723. package/src/watchdog/emission-guard.d.ts +36 -0
  724. package/src/watchdog/emission-guard.js +97 -0
  725. package/src/watchdog/guidance.d.ts +3 -0
  726. package/src/watchdog/guidance.js +19 -0
  727. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  728. package/src/watchdog/lsp-diagnostics.js +489 -0
  729. package/src/watchdog/model-selection.d.ts +24 -0
  730. package/src/watchdog/model-selection.js +167 -0
  731. package/src/watchdog/permission-arbiter.d.ts +20 -0
  732. package/src/watchdog/permission-arbiter.js +135 -0
  733. package/src/watchdog/register-child.d.ts +13 -0
  734. package/src/watchdog/register-child.js +128 -0
  735. package/src/watchdog/register-main.d.ts +11 -0
  736. package/src/watchdog/register-main.js +400 -0
  737. package/src/watchdog/render.d.ts +3 -0
  738. package/src/watchdog/render.js +33 -0
  739. package/src/watchdog/review.d.ts +36 -0
  740. package/src/watchdog/review.js +319 -0
  741. package/src/watchdog/rules.d.ts +21 -0
  742. package/src/watchdog/rules.js +58 -0
  743. package/src/watchdog/runtime.d.ts +195 -0
  744. package/src/watchdog/runtime.js +864 -0
  745. package/src/watchdog/scope.d.ts +14 -0
  746. package/src/watchdog/scope.js +44 -0
  747. package/src/watchdog/settings.d.ts +29 -0
  748. package/src/watchdog/settings.js +480 -0
  749. package/src/watchdog/tool-actions.d.ts +17 -0
  750. package/src/watchdog/tool-actions.js +150 -0
  751. package/src/watchdog/turn-delta.d.ts +15 -0
  752. package/src/watchdog/turn-delta.js +188 -0
  753. package/src/watchdog/types.d.ts +141 -0
  754. package/src/watchdog/types.js +27 -0
  755. package/src/watchdog/warning-format.d.ts +7 -0
  756. package/src/watchdog/warning-format.js +59 -0
  757. package/src/workflows/chat-progress.d.ts +37 -0
  758. package/src/workflows/chat-progress.js +129 -0
  759. package/src/workflows/host-command.d.ts +30 -0
  760. package/src/workflows/host-command.js +227 -0
  761. package/src/workflows/scripted-workflow.d.ts +204 -0
  762. package/src/workflows/scripted-workflow.js +1673 -0
  763. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  764. package/src/workflows/structured-workflow-scripts.js +179 -0
  765. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  766. package/src/workflows/workflow-auto-resume.js +102 -0
  767. package/src/workflows/workflow-checklist.d.ts +127 -0
  768. package/src/workflows/workflow-checklist.js +314 -0
  769. package/src/workflows/workflow-child-summary.d.ts +24 -0
  770. package/src/workflows/workflow-child-summary.js +195 -0
  771. package/src/workflows/workflow-launch-record.d.ts +27 -0
  772. package/src/workflows/workflow-launch-record.js +48 -0
  773. package/src/workflows/workflow-preflight.d.ts +58 -0
  774. package/src/workflows/workflow-preflight.js +288 -0
  775. package/src/workflows/workflow-receipt.d.ts +34 -0
  776. package/src/workflows/workflow-receipt.js +454 -0
  777. package/src/workflows/workflow-resources.d.ts +55 -0
  778. package/src/workflows/workflow-resources.js +271 -0
  779. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  780. package/src/workflows/workflow-resume-claim.js +210 -0
  781. package/src/workflows/workflow-resume.d.ts +56 -0
  782. package/src/workflows/workflow-resume.js +106 -0
  783. package/src/workflows/workflow-reuse.d.ts +61 -0
  784. package/src/workflows/workflow-reuse.js +186 -0
  785. package/src/workflows/workflow-revival.d.ts +33 -0
  786. package/src/workflows/workflow-revival.js +111 -0
  787. package/src/workflows/workflow-settlement.d.ts +84 -0
  788. package/src/workflows/workflow-settlement.js +203 -0
  789. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  790. package/src/workflows/workflow-stop-cause.js +8 -0
  791. package/workflow-script-worker.cjs +1342 -0
  792. package/index.ts +0 -18
  793. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  794. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  795. package/skills/pi-subagents/references/execution-controls.md +0 -561
  796. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  797. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  798. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  799. package/src/agents/advertised-agent-prompt.ts +0 -82
  800. package/src/agents/agent-eject.ts +0 -339
  801. package/src/agents/agent-management.ts +0 -1442
  802. package/src/agents/agent-memory.ts +0 -341
  803. package/src/agents/agent-refinements.ts +0 -624
  804. package/src/agents/agent-scope.ts +0 -10
  805. package/src/agents/agent-selection.ts +0 -25
  806. package/src/agents/agent-serializer.ts +0 -195
  807. package/src/agents/agents.ts +0 -3169
  808. package/src/agents/builtin-names.ts +0 -16
  809. package/src/agents/chain-serializer.ts +0 -285
  810. package/src/agents/frontmatter.ts +0 -153
  811. package/src/agents/global-npm-root.ts +0 -58
  812. package/src/agents/identity.ts +0 -30
  813. package/src/agents/proactive-skills.ts +0 -197
  814. package/src/agents/runtime-agent-events.ts +0 -70
  815. package/src/agents/runtime-agent-registry.ts +0 -457
  816. package/src/agents/runtime-discovery.ts +0 -39
  817. package/src/agents/skills.ts +0 -787
  818. package/src/api/agent-management.ts +0 -9
  819. package/src/api/agents.ts +0 -19
  820. package/src/api/background-work.ts +0 -206
  821. package/src/api/capability-ceiling.ts +0 -16
  822. package/src/api/child-tool-plan.ts +0 -5
  823. package/src/api/control-channel.ts +0 -4
  824. package/src/api/delegation.ts +0 -131
  825. package/src/api/external-job-provider.ts +0 -195
  826. package/src/api/external-runs.ts +0 -282
  827. package/src/api/inspectors.ts +0 -27
  828. package/src/api/intercom-bridge.ts +0 -3
  829. package/src/api/preflight.ts +0 -641
  830. package/src/api/project-panes.ts +0 -32
  831. package/src/api/required-child-extensions.ts +0 -6
  832. package/src/api/shared-types.ts +0 -29
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1185
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/intercom-bridge.ts +0 -235
  873. package/src/intercom/native-supervisor-channel.ts +0 -1000
  874. package/src/intercom/result-intercom.ts +0 -433
  875. package/src/intercom/supervisor-ui.ts +0 -72
  876. package/src/missions/actions.ts +0 -433
  877. package/src/missions/goal-driver.ts +0 -177
  878. package/src/missions/lifecycle.ts +0 -367
  879. package/src/missions/store.ts +0 -613
  880. package/src/missions/types.ts +0 -190
  881. package/src/missions/workflow-state.ts +0 -281
  882. package/src/policy/authority.ts +0 -50
  883. package/src/profiles/profiles.ts +0 -674
  884. package/src/runs/background/active-async-capacity.ts +0 -548
  885. package/src/runs/background/active-run-index.ts +0 -155
  886. package/src/runs/background/async-execution.ts +0 -2479
  887. package/src/runs/background/async-job-tracker.ts +0 -869
  888. package/src/runs/background/async-resume.ts +0 -686
  889. package/src/runs/background/async-retention.ts +0 -953
  890. package/src/runs/background/async-status-snapshot.ts +0 -46
  891. package/src/runs/background/async-status.ts +0 -787
  892. package/src/runs/background/auto-drain.ts +0 -92
  893. package/src/runs/background/await-async-run.ts +0 -83
  894. package/src/runs/background/binary-bootstrap.ts +0 -67
  895. package/src/runs/background/calendar-schedule.ts +0 -90
  896. package/src/runs/background/chain-append.ts +0 -321
  897. package/src/runs/background/chain-root-attachment.ts +0 -263
  898. package/src/runs/background/completion-batcher.ts +0 -168
  899. package/src/runs/background/completion-dedupe.ts +0 -58
  900. package/src/runs/background/completion-replay.ts +0 -287
  901. package/src/runs/background/control-channel.ts +0 -659
  902. package/src/runs/background/fleet-view.ts +0 -692
  903. package/src/runs/background/index-segment.ts +0 -59
  904. package/src/runs/background/inspect-rpc.ts +0 -443
  905. package/src/runs/background/notify.ts +0 -1083
  906. package/src/runs/background/owned-process-tree.ts +0 -131
  907. package/src/runs/background/parallel-groups.ts +0 -45
  908. package/src/runs/background/pid-namespace.ts +0 -18
  909. package/src/runs/background/process-terminal-candidate.ts +0 -98
  910. package/src/runs/background/process-terminal.ts +0 -231
  911. package/src/runs/background/result-delivery-ownership.ts +0 -45
  912. package/src/runs/background/result-files.ts +0 -634
  913. package/src/runs/background/result-watcher.ts +0 -842
  914. package/src/runs/background/resume-guidance.ts +0 -56
  915. package/src/runs/background/retained-children.ts +0 -136
  916. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  917. package/src/runs/background/run-child-session.ts +0 -725
  918. package/src/runs/background/run-id-query.ts +0 -7
  919. package/src/runs/background/run-id-resolver.ts +0 -183
  920. package/src/runs/background/run-status.ts +0 -803
  921. package/src/runs/background/runner-aliases.ts +0 -183
  922. package/src/runs/background/runner-child-launch.ts +0 -96
  923. package/src/runs/background/runner-child-sessions.ts +0 -32
  924. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  925. package/src/runs/background/runner-startup-failure.ts +0 -56
  926. package/src/runs/background/scheduled-runs.ts +0 -1222
  927. package/src/runs/background/stale-run-reconciler.ts +0 -463
  928. package/src/runs/background/steering.ts +0 -260
  929. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  930. package/src/runs/background/subagent-runner.ts +0 -5251
  931. package/src/runs/background/subagent-wait.ts +0 -895
  932. package/src/runs/background/terminal-run-index.ts +0 -183
  933. package/src/runs/background/top-level-async.ts +0 -14
  934. package/src/runs/background/wait-completions.ts +0 -262
  935. package/src/runs/background/wait-config.ts +0 -50
  936. package/src/runs/background/wait-subscriptions.ts +0 -354
  937. package/src/runs/background/wait-tool.ts +0 -57
  938. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  939. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  940. package/src/runs/foreground/async-steering-action.ts +0 -276
  941. package/src/runs/foreground/async-stop-action.ts +0 -216
  942. package/src/runs/foreground/command-action.ts +0 -41
  943. package/src/runs/foreground/execution.ts +0 -2315
  944. package/src/runs/foreground/foreground-control.ts +0 -157
  945. package/src/runs/foreground/foreground-history.ts +0 -164
  946. package/src/runs/foreground/prompt-audit.ts +0 -172
  947. package/src/runs/foreground/subagent-executor.ts +0 -8227
  948. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  949. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  950. package/src/runs/shared/abort-recovery.ts +0 -119
  951. package/src/runs/shared/acceptance.ts +0 -1664
  952. package/src/runs/shared/agent-contract.ts +0 -38
  953. package/src/runs/shared/async-status-projection.ts +0 -664
  954. package/src/runs/shared/background-process-options.ts +0 -9
  955. package/src/runs/shared/capability-ceiling.ts +0 -214
  956. package/src/runs/shared/chain-outputs.ts +0 -116
  957. package/src/runs/shared/child-commands.ts +0 -229
  958. package/src/runs/shared/child-hooks.ts +0 -175
  959. package/src/runs/shared/child-identity.ts +0 -62
  960. package/src/runs/shared/child-launch-plan.ts +0 -163
  961. package/src/runs/shared/child-launch.ts +0 -389
  962. package/src/runs/shared/child-lifecycle.ts +0 -28
  963. package/src/runs/shared/child-runtime-config.ts +0 -136
  964. package/src/runs/shared/child-session.ts +0 -699
  965. package/src/runs/shared/child-tool-plan.ts +0 -599
  966. package/src/runs/shared/claude-code-adapter.ts +0 -288
  967. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  968. package/src/runs/shared/context-mode.ts +0 -44
  969. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  970. package/src/runs/shared/dynamic-fanout.ts +0 -297
  971. package/src/runs/shared/effective-system-prompt.ts +0 -33
  972. package/src/runs/shared/extension-bindings.ts +0 -103
  973. package/src/runs/shared/external-cli-contract.ts +0 -177
  974. package/src/runs/shared/external-cli-preflight.ts +0 -190
  975. package/src/runs/shared/external-cli-runner.ts +0 -437
  976. package/src/runs/shared/external-job-bridge.ts +0 -514
  977. package/src/runs/shared/external-job-runner.ts +0 -389
  978. package/src/runs/shared/fast-mode-extension.ts +0 -10
  979. package/src/runs/shared/fork-command-result.ts +0 -10
  980. package/src/runs/shared/git-environment.ts +0 -29
  981. package/src/runs/shared/herdr-connection.ts +0 -134
  982. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  983. package/src/runs/shared/herdr-machine.ts +0 -279
  984. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  985. package/src/runs/shared/herdr-placed-run.ts +0 -264
  986. package/src/runs/shared/host-step-status.ts +0 -231
  987. package/src/runs/shared/lane-metadata.ts +0 -126
  988. package/src/runs/shared/launch-cwd.ts +0 -16
  989. package/src/runs/shared/long-running-guard.ts +0 -221
  990. package/src/runs/shared/mcp-config-sources.ts +0 -426
  991. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  992. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  993. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  994. package/src/runs/shared/model-resolution.ts +0 -503
  995. package/src/runs/shared/model-scope.ts +0 -224
  996. package/src/runs/shared/mutation-evidence.ts +0 -199
  997. package/src/runs/shared/nested-events.ts +0 -1125
  998. package/src/runs/shared/nested-path.ts +0 -38
  999. package/src/runs/shared/nested-render.ts +0 -127
  1000. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1001. package/src/runs/shared/parallel-handoff.ts +0 -789
  1002. package/src/runs/shared/parallel-utils.ts +0 -292
  1003. package/src/runs/shared/partial-output.ts +0 -48
  1004. package/src/runs/shared/permissions.ts +0 -86
  1005. package/src/runs/shared/pi-spawn.ts +0 -205
  1006. package/src/runs/shared/process-signal.ts +0 -35
  1007. package/src/runs/shared/profile-extensions.ts +0 -134
  1008. package/src/runs/shared/profile-launch-env.ts +0 -121
  1009. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1010. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1011. package/src/runs/shared/run-history.ts +0 -288
  1012. package/src/runs/shared/runner-launcher.ts +0 -25
  1013. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1014. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1015. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1016. package/src/runs/shared/session-lease.ts +0 -293
  1017. package/src/runs/shared/single-output.ts +0 -366
  1018. package/src/runs/shared/spawn-budget.ts +0 -128
  1019. package/src/runs/shared/structured-output.ts +0 -463
  1020. package/src/runs/shared/subagent-control.ts +0 -295
  1021. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1022. package/src/runs/shared/tool-availability.ts +0 -37
  1023. package/src/runs/shared/tool-budget.ts +0 -87
  1024. package/src/runs/shared/tool-timeout.ts +0 -93
  1025. package/src/runs/shared/usage-budget.ts +0 -65
  1026. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1027. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1028. package/src/runs/shared/workflow-graph.ts +0 -225
  1029. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1030. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1031. package/src/runs/shared/worktree-lock.ts +0 -29
  1032. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1033. package/src/runs/shared/worktree.ts +0 -1554
  1034. package/src/shared/accessible-dir.ts +0 -47
  1035. package/src/shared/agent-stream-options.ts +0 -5
  1036. package/src/shared/artifacts.ts +0 -281
  1037. package/src/shared/atomic-json.ts +0 -85
  1038. package/src/shared/capacity-resilient-json.ts +0 -102
  1039. package/src/shared/child-cache-retention.ts +0 -43
  1040. package/src/shared/child-session-name.ts +0 -48
  1041. package/src/shared/child-transcript.ts +0 -264
  1042. package/src/shared/completion-owner.ts +0 -14
  1043. package/src/shared/disabled-features.ts +0 -123
  1044. package/src/shared/display-text.ts +0 -150
  1045. package/src/shared/edit-distance.ts +0 -33
  1046. package/src/shared/extension-context.ts +0 -37
  1047. package/src/shared/file-coalescer.ts +0 -49
  1048. package/src/shared/file-lease.ts +0 -74
  1049. package/src/shared/file-system-retry.ts +0 -95
  1050. package/src/shared/fork-context.ts +0 -243
  1051. package/src/shared/fork-session-cwd.ts +0 -27
  1052. package/src/shared/formatters.ts +0 -142
  1053. package/src/shared/jsonl-writer.ts +0 -92
  1054. package/src/shared/launch-contract.ts +0 -206
  1055. package/src/shared/model-info.ts +0 -132
  1056. package/src/shared/model-response-aliases.ts +0 -13
  1057. package/src/shared/node-executable.ts +0 -21
  1058. package/src/shared/opencode-session-headers.ts +0 -30
  1059. package/src/shared/package-version.ts +0 -17
  1060. package/src/shared/parent-wake.ts +0 -79
  1061. package/src/shared/permission-profile.ts +0 -56
  1062. package/src/shared/prompt-resources.ts +0 -11
  1063. package/src/shared/pruned-fork.ts +0 -469
  1064. package/src/shared/required-child-extensions.ts +0 -115
  1065. package/src/shared/runtime-module-path.ts +0 -19
  1066. package/src/shared/sandbox-profile.ts +0 -37
  1067. package/src/shared/session-file-trust.ts +0 -19
  1068. package/src/shared/session-identity.ts +0 -10
  1069. package/src/shared/session-tokens.ts +0 -55
  1070. package/src/shared/settings-file-lease.ts +0 -36
  1071. package/src/shared/settings.ts +0 -412
  1072. package/src/shared/shortcuts.ts +0 -13
  1073. package/src/shared/status-format.ts +0 -55
  1074. package/src/shared/thinking-ceiling.ts +0 -46
  1075. package/src/shared/types.ts +0 -3105
  1076. package/src/shared/utf8.ts +0 -11
  1077. package/src/shared/utils.ts +0 -610
  1078. package/src/shared/watch-strategy.ts +0 -12
  1079. package/src/shared/workflow-child-permit.ts +0 -212
  1080. package/src/slash/delegation-adapters.ts +0 -452
  1081. package/src/slash/delegation-json.ts +0 -108
  1082. package/src/slash/delegation-request.ts +0 -176
  1083. package/src/slash/prompt-template-bridge.ts +0 -434
  1084. package/src/slash/prompt-workflows.ts +0 -298
  1085. package/src/slash/selector.ts +0 -147
  1086. package/src/slash/slash-bridge.ts +0 -192
  1087. package/src/slash/slash-commands.ts +0 -1096
  1088. package/src/slash/slash-live-state.ts +0 -310
  1089. package/src/slash/subagent-cost.ts +0 -317
  1090. package/src/slash/subagents-admin.ts +0 -489
  1091. package/src/tui/fleet-native-transcript.ts +0 -424
  1092. package/src/tui/fleet-status.ts +0 -1139
  1093. package/src/tui/fleet-transcript.ts +0 -591
  1094. package/src/tui/fleet.ts +0 -1618
  1095. package/src/tui/mouse-events.ts +0 -42
  1096. package/src/tui/render-helpers.ts +0 -111
  1097. package/src/tui/render.ts +0 -3824
  1098. package/src/tui/running-tone.ts +0 -28
  1099. package/src/tui/subagent-messages.ts +0 -305
  1100. package/src/ui-silent-marker.ts +0 -32
  1101. package/src/watchdog/change-signature.ts +0 -260
  1102. package/src/watchdog/child-status.ts +0 -225
  1103. package/src/watchdog/diff-tool.ts +0 -112
  1104. package/src/watchdog/emission-guard.ts +0 -125
  1105. package/src/watchdog/guidance.ts +0 -20
  1106. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1107. package/src/watchdog/model-selection.ts +0 -187
  1108. package/src/watchdog/permission-arbiter.ts +0 -154
  1109. package/src/watchdog/register-child.ts +0 -136
  1110. package/src/watchdog/register-main.ts +0 -425
  1111. package/src/watchdog/render.ts +0 -31
  1112. package/src/watchdog/review.ts +0 -362
  1113. package/src/watchdog/rules.ts +0 -70
  1114. package/src/watchdog/runtime.ts +0 -927
  1115. package/src/watchdog/scope.ts +0 -51
  1116. package/src/watchdog/settings.ts +0 -520
  1117. package/src/watchdog/tool-actions.ts +0 -156
  1118. package/src/watchdog/turn-delta.ts +0 -190
  1119. package/src/watchdog/types.ts +0 -186
  1120. package/src/watchdog/warning-format.ts +0 -72
  1121. package/src/workflows/chat-progress.ts +0 -152
  1122. package/src/workflows/host-command.ts +0 -235
  1123. package/src/workflows/scripted-workflow.ts +0 -2733
  1124. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1125. package/src/workflows/workflow-checklist.ts +0 -442
  1126. package/src/workflows/workflow-child-summary.ts +0 -172
  1127. package/src/workflows/workflow-preflight.ts +0 -297
  1128. package/src/workflows/workflow-receipt.ts +0 -390
  1129. package/src/workflows/workflow-resources.ts +0 -275
  1130. package/src/workflows/workflow-reuse.ts +0 -120
  1131. package/src/workflows/workflow-revival.ts +0 -123
  1132. package/src/workflows/workflow-settlement.ts +0 -252
@@ -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
+ };