@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,1372 @@
1
+ import {
2
+ isTrustedRecordedSessionFile,
3
+ resolveSubagentRunId
4
+ } from "./chunk-RK2HDPLK.js";
5
+ import {
6
+ formatShellCommand
7
+ } from "./chunk-7J4ZXMY7.js";
8
+ import {
9
+ agentStreamOptions,
10
+ opencodeSessionHeaders,
11
+ ownsRun,
12
+ resolveAsyncResumeTarget
13
+ } from "./chunk-3G4JXNZ4.js";
14
+ import {
15
+ currentCompletionOwnerId,
16
+ listMissions,
17
+ missionRecordPath,
18
+ readMissionBinding,
19
+ reconcileAsyncRun,
20
+ resolveAuthorityDecision,
21
+ resolveMissionStoreLocation
22
+ } from "./chunk-ICNYIALB.js";
23
+ import {
24
+ deliverInterruptRequest,
25
+ queueRevivalBrief,
26
+ requestAsyncSteer
27
+ } from "./chunk-RB4GELQA.js";
28
+ import {
29
+ readStatus,
30
+ redactSecretValues,
31
+ resolveNodeExecutable,
32
+ tryLease,
33
+ writeAtomicJson,
34
+ writePrivateAtomicJson
35
+ } from "./chunk-V2KFIGFH.js";
36
+ import {
37
+ DIRS
38
+ } from "./chunk-UQDHXMUG.js";
39
+ import {
40
+ previewDisplayText,
41
+ safeTerminalText
42
+ } from "./chunk-YFCK7H2S.js";
43
+
44
+ // src/runs/background/steering.ts
45
+ import * as fs from "node:fs";
46
+ import * as path from "node:path";
47
+ var MAX_STEERING_REQUESTS = 20;
48
+ var STEERING_MESSAGE_PREVIEW_LIMIT = 160;
49
+ function steeringMessagePreview(message) {
50
+ return previewDisplayText(redactSecretValues(message), STEERING_MESSAGE_PREVIEW_LIMIT);
51
+ }
52
+ function steeringReceipt(message, receipt) {
53
+ const preview = steeringMessagePreview(message);
54
+ const longestFence = Math.max(2, ...[...preview.matchAll(/`{3,}/g)].map((match) => match[0].length));
55
+ const fence = "`".repeat(longestFence + 1);
56
+ return `${receipt}
57
+
58
+ Message sent:
59
+ ${fence}text
60
+ ${preview}
61
+ ${fence}`;
62
+ }
63
+ function createSteeringStatus() {
64
+ return { requested: 0, scheduled: 0, pending: 0, delivered: 0, failed: 0, recovered: 0, recent: [] };
65
+ }
66
+ function steeringStatus(status) {
67
+ return status.steering ?? createSteeringStatus();
68
+ }
69
+ function recordSteeringRequest(status, input) {
70
+ const existing = status.recent.find((request2) => request2.id === input.id);
71
+ if (existing) return existing;
72
+ const request = {
73
+ id: input.id,
74
+ requestedAt: input.requestedAt,
75
+ ...input.source ? { source: input.source } : {},
76
+ messagePreview: steeringMessagePreview(input.message),
77
+ targets: input.targets.map((target) => ({ index: target.index, state: target.state, ...target.reason ? { reason: target.reason } : {} }))
78
+ };
79
+ status.requested++;
80
+ status.lastRequestedAt = input.requestedAt;
81
+ status.recent = [...status.recent, request].slice(-MAX_STEERING_REQUESTS);
82
+ for (const target of request.targets) incrementStateCount(status, target.state);
83
+ return request;
84
+ }
85
+ function incrementStateCount(status, state) {
86
+ if (state === "scheduled") status.scheduled++;
87
+ else if (state === "routed" || state === "queued") status.pending++;
88
+ else if (state === "delivered" || state === "late") status.delivered++;
89
+ else if (state === "failed") status.failed++;
90
+ else if (state === "recovered") status.recovered++;
91
+ }
92
+ function updateSteeringTarget(status, requestId, index, state, now, fields = {}) {
93
+ const request = status.recent.find((candidate) => candidate.id === requestId);
94
+ const target = request?.targets.find((candidate) => candidate.index === index);
95
+ if (!target) return void 0;
96
+ if (state === "late" && target.state === "recovered") {
97
+ if (target.lateDeliveredAt === void 0) {
98
+ target.lateDeliveredAt = now;
99
+ status.delivered++;
100
+ status.lastDeliveredAt = now;
101
+ }
102
+ if (fields.reason) target.reason = fields.reason;
103
+ return target;
104
+ }
105
+ if (target.state === state) {
106
+ if (state === "routed" && target.routedAt === void 0) target.routedAt = now;
107
+ if (state === "delivered" && target.deliveredAt === void 0) target.deliveredAt = now;
108
+ if (state === "late" && target.lateDeliveredAt === void 0) target.lateDeliveredAt = now;
109
+ if (fields.reason) target.reason = fields.reason;
110
+ if (fields.replacementRunId) target.replacementRunId = fields.replacementRunId;
111
+ return target;
112
+ }
113
+ const wasPending = target.state === "routed" || target.state === "queued";
114
+ const nowPending = state === "routed" || state === "queued";
115
+ if (wasPending && !nowPending) status.pending = Math.max(0, status.pending - 1);
116
+ target.state = state;
117
+ if (state === "routed") target.routedAt = now;
118
+ if (state === "delivered") {
119
+ target.deliveredAt = now;
120
+ status.lastDeliveredAt = now;
121
+ }
122
+ if (state === "late") {
123
+ target.lateDeliveredAt = now;
124
+ status.lastDeliveredAt = now;
125
+ }
126
+ if (state === "failed") target.failedAt = now;
127
+ if (state === "recovered") target.recoveredAt = now;
128
+ if (fields.reason) target.reason = fields.reason;
129
+ if (fields.replacementRunId) target.replacementRunId = fields.replacementRunId;
130
+ if (!wasPending || !nowPending) incrementStateCount(status, state);
131
+ return target;
132
+ }
133
+ function findSteeringRequest(status, requestId) {
134
+ return status.recent.find((request) => request.id === requestId);
135
+ }
136
+ function actionResultFromSteeringStatus(status, sourceRunId, requestId, replacementRunId) {
137
+ const request = findSteeringRequest(status, requestId);
138
+ if (!request) return void 0;
139
+ const targets = request.targets.map((target) => ({
140
+ index: target.index,
141
+ state: target.state,
142
+ ...target.deliveredAt !== void 0 ? { deliveredAt: target.deliveredAt } : {},
143
+ ...target.lateDeliveredAt !== void 0 ? { lateDeliveredAt: target.lateDeliveredAt } : {},
144
+ ...target.reason ? { reason: target.reason } : {},
145
+ ...target.replacementRunId ? { replacementRunId: target.replacementRunId } : {}
146
+ }));
147
+ const states = targets.map((target) => target.state);
148
+ let state = "pending";
149
+ if (states.length > 0 && states.every((candidate) => candidate === "delivered")) state = "delivered";
150
+ else if (states.length > 0 && states.every((candidate) => candidate === "scheduled")) state = "scheduled";
151
+ else if (states.length > 0 && states.every((candidate) => candidate === "recovered")) state = "recovered";
152
+ else if (states.length > 0 && states.every((candidate) => candidate === "failed" || candidate === "late")) state = "failed";
153
+ else if (states.some((candidate) => candidate === "failed" || candidate === "late") && states.some((candidate) => candidate !== "failed" && candidate !== "late")) state = "partial";
154
+ const effectiveReplacementRunId = replacementRunId ?? request.targets.find((target) => target.replacementRunId)?.replacementRunId;
155
+ const deliveryStatus = states.length > 0 && states.every((candidate) => candidate === "delivered" || candidate === "recovered") ? "delivered" : "queued";
156
+ return { requestId, state, deliveryStatus, sourceRunId, ...effectiveReplacementRunId ? { replacementRunId: effectiveReplacementRunId } : {}, targets };
157
+ }
158
+ function steeringActionIsTerminal(result2) {
159
+ return (result2?.targets.length ?? 0) > 0 && result2?.targets.every((target) => target.state === "queued" || target.state === "delivered") === true || result2?.state === "delivered" || result2?.state === "scheduled" || result2?.state === "partial" || result2?.state === "recovered" || result2?.state === "failed";
160
+ }
161
+ function claimSteeringRecovery(asyncDir, input) {
162
+ const recoveryDir = path.join(asyncDir, "control", "steer-recovery");
163
+ fs.mkdirSync(recoveryDir, { recursive: true, mode: 448 });
164
+ const claimPath = path.join(recoveryDir, "claim.json");
165
+ let fd;
166
+ try {
167
+ fd = fs.openSync(claimPath, "wx", 384);
168
+ } catch (error) {
169
+ if (error.code === "EEXIST") {
170
+ throw new Error("Another steering recovery is already committed for this source run.");
171
+ }
172
+ throw error;
173
+ }
174
+ let writeError;
175
+ try {
176
+ fs.writeFileSync(fd, JSON.stringify({ version: 1, ...input }, null, 2), "utf-8");
177
+ fs.fsyncSync(fd);
178
+ } catch (error) {
179
+ writeError = error;
180
+ } finally {
181
+ fs.closeSync(fd);
182
+ }
183
+ if (writeError !== void 0) {
184
+ fs.rmSync(claimPath, { force: true });
185
+ throw writeError;
186
+ }
187
+ const markerPath = path.join(recoveryDir, `${Buffer.from(input.requestId).toString("base64url")}.json`);
188
+ try {
189
+ writePrivateAtomicJson(markerPath, { version: 1, ...input });
190
+ } catch (error) {
191
+ fs.rmSync(claimPath, { force: true });
192
+ throw error;
193
+ }
194
+ return { claimPath, markerPath };
195
+ }
196
+ function readSteeringStatus(asyncDir) {
197
+ return readStatus(asyncDir)?.steering;
198
+ }
199
+ function remainingSteeringRecoveryLimits(descriptor, status, now = Date.now()) {
200
+ const limits = {};
201
+ if (descriptor.absoluteDeadlineAt !== void 0) {
202
+ const timeoutMs = descriptor.absoluteDeadlineAt - now;
203
+ if (timeoutMs <= 0) throw new Error("Source run has no remaining deadline budget; it remains paused.");
204
+ limits.timeoutMs = timeoutMs;
205
+ limits.absoluteDeadlineAt = descriptor.absoluteDeadlineAt;
206
+ }
207
+ if (descriptor.initialToolBudget) {
208
+ const consumed = status.toolBudget?.toolCount ?? status.toolCount ?? 0;
209
+ const hard = descriptor.initialToolBudget.hard - consumed;
210
+ if (hard <= 0) throw new Error("Source run has no remaining tool budget; it remains paused.");
211
+ const soft = descriptor.initialToolBudget.soft === void 0 ? void 0 : descriptor.initialToolBudget.soft - consumed;
212
+ limits.toolBudget = {
213
+ hard,
214
+ ...soft !== void 0 && soft > 0 && soft < hard ? { soft } : {},
215
+ block: descriptor.initialToolBudget.block
216
+ };
217
+ }
218
+ return limits;
219
+ }
220
+ async function waitForSteeringAction(input) {
221
+ const deadline = Date.now() + input.timeoutMs;
222
+ while (Date.now() <= deadline) {
223
+ if (input.signal?.aborted) return void 0;
224
+ const status2 = readSteeringStatus(input.asyncDir);
225
+ const result2 = status2 ? actionResultFromSteeringStatus(status2, input.sourceRunId, input.requestId) : void 0;
226
+ if (steeringActionIsTerminal(result2)) return result2;
227
+ await new Promise((resolve3) => setTimeout(resolve3, Math.min(50, Math.max(1, deadline - Date.now()))));
228
+ }
229
+ const status = readSteeringStatus(input.asyncDir);
230
+ return status ? actionResultFromSteeringStatus(status, input.sourceRunId, input.requestId) : void 0;
231
+ }
232
+
233
+ // src/runs/foreground/async-steering-action.ts
234
+ import { randomUUID } from "node:crypto";
235
+ import * as fs2 from "node:fs";
236
+ import * as path2 from "node:path";
237
+ function steerTargetsAccepted(result2) {
238
+ const targets = result2?.targets ?? [];
239
+ return targets.length > 0 && targets.every((target) => target.state === "queued" || target.state === "delivered");
240
+ }
241
+ function canQueueRetainedAsyncFollowUp(status, index) {
242
+ const steps = status.steps ?? [];
243
+ return status.state === "complete" && Boolean(status.parentWorkflowRunId) && steps.length === 1 && (steps[0]?.status === "complete" || steps[0]?.status === "completed") && Boolean(steps[0]?.sessionFile ?? status.sessionFile) && (index === void 0 || index === 0);
244
+ }
245
+ async function steerAsyncRun(input) {
246
+ if (!input.location.asyncDir) {
247
+ return {
248
+ content: [{ type: "text", text: `Async run '${input.runId}' has no live run directory to steer.` }],
249
+ isError: true,
250
+ details: { mode: "management", results: [] }
251
+ };
252
+ }
253
+ const asyncDir = input.location.asyncDir;
254
+ const snapshot = input.findPendingAsks ? readStatus(asyncDir) : null;
255
+ if (snapshot?.mode === "single" && (!input.state.currentSessionId || ownsRun(input.state.currentSessionId, snapshot.sessionId)) && (snapshot.state === "running" || snapshot.state === "queued") && snapshot.steps?.length === 1 && (input.index === void 0 || input.index === 0) && (snapshot.steps[0]?.status === "running" || snapshot.steps[0]?.status === "pending")) {
256
+ const asks = input.findPendingAsks?.({ runId: snapshot.runId, agent: snapshot.steps[0].agent, childIndex: 0 }) ?? [];
257
+ if (asks.length > 0) {
258
+ const replies = asks.map((replyTo) => `subagent_supervisor(${JSON.stringify({ action: "reply", replyTo, message: "<explicit answer>" })})`).join("\n");
259
+ return {
260
+ content: [{ type: "text", text: `Steering not delivered or queued: async run ${snapshot.runId} is blocked on ${asks.length === 1 ? "a pending supervisor ask" : "ambiguous pending supervisor asks"}. No reply or recovery was attempted. Reply explicitly${asks.length > 1 ? " to the intended request ID" : ""}:
261
+ ${replies}` }],
262
+ isError: true,
263
+ details: { mode: "management", results: [] }
264
+ };
265
+ }
266
+ }
267
+ const status = reconcileAsyncRun(asyncDir, { kill: input.kill }).status;
268
+ if (input.state.currentSessionId && !ownsRun(input.state.currentSessionId, status?.sessionId)) {
269
+ return {
270
+ content: [{ type: "text", text: `Async run '${input.runId}' was not found in the active session.` }],
271
+ isError: true,
272
+ details: { mode: "management", results: [] }
273
+ };
274
+ }
275
+ if (!status) {
276
+ return {
277
+ content: [{ type: "text", text: `Async run '${input.runId}' was not found.` }],
278
+ isError: true,
279
+ details: { mode: "management", results: [] }
280
+ };
281
+ }
282
+ const steps = status.steps ?? [];
283
+ if (status.state !== "running" && status.state !== "queued") {
284
+ const followUpEligible = canQueueRetainedAsyncFollowUp(status, input.index);
285
+ const retained = input.mode === "follow_up" && followUpEligible;
286
+ if (!retained) {
287
+ let resumeHint = `Continue it with action "resume", or read its saved result.`;
288
+ try {
289
+ resolveAsyncResumeTarget({ dir: asyncDir, index: input.index }, { kill: input.kill }, { requireSessionFile: false, sessionId: input.state.currentSessionId ?? void 0 });
290
+ } catch (error) {
291
+ resumeHint = `action "resume" is not available either: ${error instanceof Error ? error.message : String(error)}`;
292
+ }
293
+ const hint = followUpEligible ? `Queue this message for its next resume with mode "follow_up", or continue the run now with action "resume".` : input.mode === "follow_up" ? `mode "follow_up" requires a completed single-child workflow run with a persisted session. ${resumeHint}` : resumeHint;
294
+ return {
295
+ content: [{ type: "text", text: `Async run '${input.runId}' is ${status.state} and cannot be steered; steering requires state "running" or "queued". ${hint}` }],
296
+ isError: true,
297
+ details: { mode: "management", results: [] }
298
+ };
299
+ }
300
+ const request = { type: "steer", id: randomUUID(), ts: Date.now(), message: input.message.trim(), mode: "follow_up", targetIndex: 0, source: "steer-action" };
301
+ try {
302
+ queueRevivalBrief(asyncDir, request);
303
+ } catch (error) {
304
+ return { content: [{ type: "text", text: `Failed to queue retained follow-up for async run ${status.runId}: ${error instanceof Error ? error.message : String(error)}` }], isError: true, details: { mode: "management", results: [] } };
305
+ }
306
+ status.steering ??= createSteeringStatus();
307
+ recordSteeringRequest(status.steering, { id: request.id, requestedAt: request.ts, source: request.source, message: request.message, targets: [{ index: 0, state: "scheduled" }] });
308
+ writeAtomicJson(path2.join(asyncDir, "status.json"), status);
309
+ const queued = { requestId: request.id, state: "scheduled", deliveryStatus: "queued", sourceRunId: status.runId, targets: [{ index: 0, state: "scheduled" }] };
310
+ return { content: [{ type: "text", text: steeringReceipt(request.message, `Follow-up queued for the next resume of retained async run ${status.runId} (request ${request.id}).`) }], details: { mode: "management", results: [], steering: queued } };
311
+ }
312
+ if (input.index !== void 0) {
313
+ if (input.index < 0 || input.index >= steps.length) {
314
+ return {
315
+ content: [{ type: "text", text: `Async run '${status.runId}' has ${steps.length} children. Index ${input.index} is out of range.` }],
316
+ isError: true,
317
+ details: { mode: "management", results: [] }
318
+ };
319
+ }
320
+ const targetStep = steps[input.index];
321
+ if (targetStep && targetStep.status !== "running" && targetStep.status !== "pending") {
322
+ return {
323
+ content: [{ type: "text", text: `Async run '${status.runId}' child ${input.index} is ${targetStep.status} and cannot be steered.` }],
324
+ isError: true,
325
+ details: { mode: "management", results: [] }
326
+ };
327
+ }
328
+ } else {
329
+ const running2 = steps.filter((step) => step.status === "running");
330
+ if (running2.length === 0 && steps.length > 1) {
331
+ return {
332
+ content: [{ type: "text", text: `Async run '${status.runId}' has no running child yet. Provide index to steer a queued child.` }],
333
+ isError: true,
334
+ details: { mode: "management", results: [] }
335
+ };
336
+ }
337
+ }
338
+ const runningIndexes = steps.map((step, index) => step.status === "running" ? index : void 0).filter((index) => index !== void 0);
339
+ const effectiveTargetIndex = input.index ?? (status.mode === "single" && runningIndexes.length === 0 && steps[0]?.status === "pending" ? 0 : void 0);
340
+ const targetIndexes = effectiveTargetIndex !== void 0 ? [effectiveTargetIndex] : runningIndexes;
341
+ if (targetIndexes.length === 0) {
342
+ return {
343
+ content: [{ type: "text", text: `Async run '${status.runId}' has no running child to steer.` }],
344
+ isError: true,
345
+ details: { mode: "management", results: [] }
346
+ };
347
+ }
348
+ const requestId = randomUUID();
349
+ let requestPath;
350
+ try {
351
+ requestPath = requestAsyncSteer(asyncDir, {
352
+ message: input.message,
353
+ mode: input.mode,
354
+ ...effectiveTargetIndex !== void 0 ? { targetIndex: effectiveTargetIndex } : { targetIndexes },
355
+ source: "steer-action",
356
+ id: requestId
357
+ });
358
+ } catch (error) {
359
+ return {
360
+ content: [{ type: "text", text: `Failed to queue steering for async run ${status.runId}: ${error instanceof Error ? error.message : String(error)}` }],
361
+ isError: true,
362
+ details: { mode: "management", results: [] }
363
+ };
364
+ }
365
+ input.onRequestQueued?.(requestPath);
366
+ const tracked = input.state.asyncJobs.get(status.runId);
367
+ if (tracked) tracked.updatedAt = Date.now();
368
+ const targets = targetIndexes.map((index) => ({ index, state: status.steps?.[index]?.status === "pending" ? "scheduled" : "pending" }));
369
+ if (targets.every((target) => target.state === "scheduled")) {
370
+ const scheduled = { requestId, state: "scheduled", deliveryStatus: "queued", sourceRunId: status.runId, targets };
371
+ return { content: [{ type: "text", text: steeringReceipt(input.message, `Steering scheduled for async run ${status.runId} (request ${requestId}).`) }], details: { mode: "management", results: [], steering: scheduled } };
372
+ }
373
+ const waited = await waitForSteeringAction({ asyncDir, sourceRunId: status.runId, requestId, timeoutMs: input.ackTimeoutMs ?? 3e3, signal: input.signal });
374
+ const result2 = waited ?? { requestId, state: "pending", deliveryStatus: "queued", sourceRunId: status.runId, targets };
375
+ if (input.signal?.aborted) {
376
+ return { content: [{ type: "text", text: steeringReceipt(input.message, `Steering pending for async run ${status.runId} (request ${requestId}); caller aborted before recovery.`) }], details: { mode: "management", results: [], steering: result2 } };
377
+ }
378
+ const finalStatus = readStatus(asyncDir);
379
+ const finalResult = finalStatus?.steering ? actionResultFromSteeringStatus(finalStatus.steering, status.runId, requestId) : void 0;
380
+ const acceptedReply = (accepted) => {
381
+ const acceptedState = accepted.state === "delivered" ? "delivered" : "queued";
382
+ return { content: [{ type: "text", text: steeringReceipt(input.message, `Steering ${acceptedState} for async run ${status.runId} (request ${requestId}).`) }], details: { mode: "management", results: [], steering: accepted } };
383
+ };
384
+ if (finalResult && steerTargetsAccepted(finalResult)) return acceptedReply(finalResult);
385
+ const running = (finalStatus?.steps ?? status.steps ?? []).filter((step) => step.status === "running");
386
+ const recoveryAllowed = (input.mode ?? "steer") === "steer" && status.mode === "single" && status.isNested !== true && running.length === 1 && Boolean(finalStatus?.steering) && (input.index === void 0 || input.index === 0);
387
+ if (recoveryAllowed && finalResult?.state !== "scheduled" && input.recover) {
388
+ const appendSteeringNotice = (state, message) => {
389
+ try {
390
+ fs2.appendFileSync(path2.join(asyncDir, "events.jsonl"), `${JSON.stringify({ type: "subagent.steering.notice", ts: Date.now(), runId: status.runId, requestId, state, message, ...status.sessionId ? { currentSessionId: status.sessionId } : {} })}
391
+ `);
392
+ } catch {
393
+ }
394
+ };
395
+ try {
396
+ const latest = readStatus(asyncDir);
397
+ const latestResult = latest?.steering ? actionResultFromSteeringStatus(latest.steering, status.runId, requestId) : void 0;
398
+ if (latestResult && steerTargetsAccepted(latestResult)) return acceptedReply(latestResult);
399
+ const committedAt = Date.now();
400
+ input.onBeforeRecoveryClaim?.(requestId, committedAt);
401
+ const { claimPath, markerPath } = claimSteeringRecovery(asyncDir, { requestId, sourceRunId: status.runId, committedAt });
402
+ input.onRecoveryCommitted?.(requestId, committedAt);
403
+ const preCommitStatus = readStatus(asyncDir);
404
+ const preCommitResult = preCommitStatus?.steering ? actionResultFromSteeringStatus(preCommitStatus.steering, status.runId, requestId) : void 0;
405
+ if (preCommitResult && preCommitResult.targets.length > 0 && preCommitResult.targets.every((target) => target.state === "queued" || target.deliveredAt !== void 0 && target.deliveredAt <= committedAt)) {
406
+ fs2.rmSync(markerPath, { force: true });
407
+ fs2.rmSync(claimPath, { force: true });
408
+ return acceptedReply(preCommitResult);
409
+ }
410
+ try {
411
+ deliverInterruptRequest({ asyncDir, source: "steering-recovery" });
412
+ } catch (error) {
413
+ fs2.rmSync(markerPath, { force: true });
414
+ fs2.rmSync(claimPath, { force: true });
415
+ throw new Error(`Failed to commit steering recovery interrupt: ${error instanceof Error ? error.message : String(error)}`);
416
+ }
417
+ const pauseBudgetMs = input.recoveryTimeoutMs ?? 15e3;
418
+ const pauseDeadline = Date.now() + pauseBudgetMs;
419
+ let paused = null;
420
+ let lastObservedState;
421
+ while (Date.now() <= pauseDeadline) {
422
+ if (input.signal?.aborted) break;
423
+ const candidate = readStatus(asyncDir);
424
+ lastObservedState = candidate?.state;
425
+ if (candidate?.state === "paused" && candidate.endedAt !== void 0) {
426
+ paused = candidate;
427
+ break;
428
+ }
429
+ await new Promise((resolve3) => setTimeout(resolve3, 50));
430
+ }
431
+ if (!paused) {
432
+ fs2.rmSync(claimPath, { force: true });
433
+ throw new Error(`Source run did not confirm a paused state within ${pauseBudgetMs / 1e3} seconds after the recovery interrupt (last observed state: ${lastObservedState ?? "unknown"}). No replacement was launched and the steering message was not applied. Once it pauses, continue it with action "resume" and id "${status.runId}".`);
434
+ }
435
+ let recoveryTarget;
436
+ try {
437
+ recoveryTarget = resolveAsyncResumeTarget(
438
+ { id: status.runId },
439
+ { kill: input.kill },
440
+ { sessionId: input.state.currentSessionId ?? void 0 }
441
+ );
442
+ } catch (error) {
443
+ throw new Error(`Source run remains paused and cannot be revived safely: ${error instanceof Error ? error.message : String(error)}`);
444
+ }
445
+ if (recoveryTarget.kind !== "revive" || !recoveryTarget.sessionFile) throw new Error("Source run has no valid persisted child session; it remains paused and requires a new run.");
446
+ if (!recoveryTarget.recoveryDescriptor) throw new Error("Source run has no private recovery descriptor; it remains paused and is not safely resumable.");
447
+ const limits = remainingSteeringRecoveryLimits(recoveryTarget.recoveryDescriptor, paused);
448
+ const revived = await input.recover(limits);
449
+ if (revived.isError || !revived.details.asyncId) throw new Error(revived.content[0]?.type === "text" ? revived.content[0].text : "Replacement launch failed; source run remains paused.");
450
+ const targetIndex = input.index ?? paused.steering?.recent.find((request) => request.id === requestId)?.targets[0]?.index ?? status.steps?.findIndex((step) => step.status === "running") ?? -1;
451
+ if (paused.steering && targetIndex >= 0) {
452
+ updateSteeringTarget(paused.steering, requestId, targetIndex, "recovered", Date.now(), { replacementRunId: revived.details.asyncId });
453
+ const stepSteering = paused.steps?.[targetIndex]?.steering;
454
+ if (stepSteering) updateSteeringTarget(stepSteering, requestId, targetIndex, "recovered", Date.now(), { replacementRunId: revived.details.asyncId });
455
+ writeAtomicJson(path2.join(asyncDir, "status.json"), paused);
456
+ }
457
+ const recovered = paused.steering ? actionResultFromSteeringStatus(paused.steering, status.runId, requestId, revived.details.asyncId) : void 0;
458
+ appendSteeringNotice("recovered", `Steering recovered for run ${status.runId}; replacement ${revived.details.asyncId} launched.`);
459
+ return { content: [{ type: "text", text: steeringReceipt(input.message, `Steering recovered for async run ${status.runId}; replacement ${revived.details.asyncId} launched after the source paused.`) }], details: { mode: "management", results: [], steering: recovered ?? { requestId, state: "recovered", sourceRunId: status.runId, replacementRunId: revived.details.asyncId, deliveryStatus: "delivered", targets: [{ index: input.index ?? 0, state: "recovered" }] } } };
460
+ } catch (error) {
461
+ const reason = error instanceof Error ? error.message : String(error);
462
+ const failedStatus = readStatus(asyncDir);
463
+ const targetIndex = input.index ?? status.steps?.findIndex((step) => step.status === "running") ?? -1;
464
+ if (failedStatus && failedStatus.state !== "running" && failedStatus.state !== "queued" && failedStatus.steering && targetIndex >= 0) {
465
+ updateSteeringTarget(failedStatus.steering, requestId, targetIndex, "failed", Date.now(), { reason });
466
+ const stepSteering = failedStatus.steps?.[targetIndex]?.steering;
467
+ if (stepSteering) updateSteeringTarget(stepSteering, requestId, targetIndex, "failed", Date.now(), { reason });
468
+ failedStatus.activityState = "needs_attention";
469
+ writeAtomicJson(path2.join(asyncDir, "status.json"), failedStatus);
470
+ }
471
+ const failed = failedStatus?.steering ? actionResultFromSteeringStatus(failedStatus.steering, status.runId, requestId) : void 0;
472
+ appendSteeringNotice("failed", `Steering failed for run ${status.runId}: ${reason}`);
473
+ return { content: [{ type: "text", text: steeringReceipt(input.message, `Steering failed for async run ${status.runId} (request ${requestId}): ${reason}`) }], isError: true, details: { mode: "management", results: [], steering: failed ?? { requestId, state: "failed", sourceRunId: status.runId, deliveryStatus: "queued", targets: [{ index: input.index ?? 0, state: "failed", reason }] } } };
474
+ }
475
+ }
476
+ const stateText = result2.state === "failed" ? "failed" : result2.state === "partial" ? "partial" : result2.deliveryStatus === "queued" ? "queued" : result2.state === "delivered" ? "delivered" : result2.state === "scheduled" ? "scheduled" : result2.state === "recovered" ? "recovered" : "pending";
477
+ const isError = result2.state === "failed" || result2.state === "partial";
478
+ return {
479
+ content: [{ type: "text", text: steeringReceipt(input.message, `Steering ${stateText} for async run ${status.runId} (request ${requestId}).`) }],
480
+ ...isError ? { isError: true } : {},
481
+ details: { mode: "management", results: [], steering: result2 }
482
+ };
483
+ }
484
+
485
+ // src/runs/foreground/workflow-foreground-steering.ts
486
+ import { randomUUID as randomUUID2 } from "node:crypto";
487
+ import * as path3 from "node:path";
488
+
489
+ // src/runs/shared/workflow-async-child-guidance.ts
490
+ function workflowAsyncChildSteeringGuidance(status, state) {
491
+ if (status.mode !== "workflow" || status.state !== "running" && status.state !== "queued" || !state?.currentSessionId || status.sessionId !== state.currentSessionId || !state.workflowControllers?.has(status.runId)) return [];
492
+ const ids = new Set((status.steps ?? []).flatMap((step) => step.async === true && step.status === "running" && step.runner?.type !== "external-cli" && step.runner?.type !== "external-job" && typeof step.runId === "string" && /^[A-Za-z0-9_-]+$/.test(step.runId) && step.runId !== status.runId ? [step.runId] : []));
493
+ if (ids.size === 0) return [];
494
+ return [
495
+ "Async children recorded as running; direct steering rechecks controls. Choose an exact child ID (queued does not mean consumed):",
496
+ ...[...ids].map((id) => ` subagent({ action: "steer", id: "${id}", message: "...", options: { mode: "follow_up" } })`)
497
+ ];
498
+ }
499
+
500
+ // src/runs/foreground/workflow-foreground-steering.ts
501
+ function activeWorkflowError(state, workflowRunId, asyncDirRoot) {
502
+ if (!state.currentSessionId) return "Workflow steering requires an active parent session.";
503
+ if (!state.workflowControllers?.has(workflowRunId)) return `Workflow '${workflowRunId}' has no live foreground child.`;
504
+ const status = readStatus(path3.join(asyncDirRoot, workflowRunId));
505
+ if (!status || status.mode !== "workflow" || status.state !== "running" && status.state !== "queued") {
506
+ return `Workflow '${workflowRunId}' has no live foreground child.`;
507
+ }
508
+ if (status.sessionId !== state.currentSessionId) return `Workflow '${workflowRunId}' was not found in the active session.`;
509
+ return void 0;
510
+ }
511
+ function controlIsLiveInWorkflow(control, workflowRunId, sessionId) {
512
+ return control.parentWorkflowRunId === workflowRunId && control.sessionId === sessionId && (control.activeChildren?.size ?? 0) > 0;
513
+ }
514
+ function resolveWorkflowForegroundSteeringTarget(input) {
515
+ const { state, childRunId, asyncDirRoot } = input;
516
+ if (childRunId) {
517
+ const control = state.foregroundControls.get(childRunId);
518
+ if (!control?.parentWorkflowRunId) return { ok: false, message: `Foreground run '${childRunId}' is not a live workflow-owned child.` };
519
+ const workflowRunId2 = control.parentWorkflowRunId;
520
+ const workflowError2 = activeWorkflowError(state, workflowRunId2, asyncDirRoot);
521
+ if (workflowError2) return { ok: false, message: workflowError2 };
522
+ if (!controlIsLiveInWorkflow(control, workflowRunId2, state.currentSessionId)) {
523
+ return { ok: false, message: `Foreground run '${childRunId}' is not a live workflow-owned child in the active session.` };
524
+ }
525
+ return { ok: true, target: { control, workflowRunId: workflowRunId2, sourceRunId: childRunId } };
526
+ }
527
+ const workflowRunId = input.workflowRunId;
528
+ if (!workflowRunId) return { ok: false, message: "Workflow steering requires a workflow or child run id." };
529
+ const workflowError = activeWorkflowError(state, workflowRunId, asyncDirRoot);
530
+ if (workflowError) return { ok: false, message: workflowError };
531
+ const controls = [...state.foregroundControls.values()].filter((control) => controlIsLiveInWorkflow(control, workflowRunId, state.currentSessionId));
532
+ if (controls.length === 0) return { ok: false, message: `Workflow '${workflowRunId}' has no live foreground child.` };
533
+ if (controls.length > 1) return { ok: false, message: `Workflow '${workflowRunId}' has ${controls.length} live foreground children; steer a child run id instead.` };
534
+ return { ok: true, target: { control: controls[0], workflowRunId, sourceRunId: workflowRunId } };
535
+ }
536
+ function managementError(message) {
537
+ return { content: [{ type: "text", text: message }], isError: true, details: { mode: "management", results: [] } };
538
+ }
539
+ async function steerWorkflowRun(input) {
540
+ const { state, runId, asyncDir } = input;
541
+ const status = readStatus(asyncDir);
542
+ if (!status || status.mode !== "workflow" || status.runId !== runId || path3.basename(asyncDir) !== runId) {
543
+ return managementError(`Workflow '${runId}' does not match its resolved run directory.`);
544
+ }
545
+ if (state.workflowControllers?.has(runId)) {
546
+ const route = resolveWorkflowForegroundSteeringTarget({ state, workflowRunId: runId, asyncDirRoot: path3.dirname(asyncDir) });
547
+ if (!route.ok) return managementError([route.message, ...workflowAsyncChildSteeringGuidance(status, state)].join("\n"));
548
+ return steerWorkflowForegroundTarget({ target: route.target, message: input.message, mode: input.mode, index: input.index });
549
+ }
550
+ if (!state.currentSessionId) return managementError("Workflow steering requires an active parent session.");
551
+ if (status.sessionId !== state.currentSessionId) return managementError(`Workflow '${runId}' was not found in the active session.`);
552
+ if (status.state !== "running" && status.state !== "queued") return managementError(`Workflow '${runId}' is not running or queued and cannot be steered.`);
553
+ if (typeof status.completionOwnerId !== "string" || !status.completionOwnerId.trim() || status.completionOwnerId === (state.completionOwnerId ?? currentCompletionOwnerId()) || [...state.foregroundControls.values()].some((control) => control.parentWorkflowRunId === runId)) {
554
+ return managementError(`Workflow '${runId}' has no live foreground child and is not a recorded foreign workflow.`);
555
+ }
556
+ if (input.index !== void 0) {
557
+ const step = status.steps?.[input.index];
558
+ if (!Number.isInteger(input.index) || input.index < 0 || !step) return managementError(`Workflow '${runId}' index ${input.index} is out of range or invalid.`);
559
+ if (step.status !== "running" && step.status !== "pending") return managementError(`Workflow '${runId}' child ${input.index} is ${step.status} and cannot be steered.`);
560
+ if (typeof step.workflowKey !== "string" || !step.workflowKey.trim()) return managementError(`Workflow '${runId}' child ${input.index} has no projected workflow key.`);
561
+ }
562
+ const requestId = randomUUID2();
563
+ try {
564
+ requestAsyncSteer(asyncDir, { id: requestId, message: input.message, mode: input.mode, ...input.index !== void 0 ? { targetIndex: input.index } : {}, source: "steer-action" });
565
+ } catch (error) {
566
+ return managementError(`Failed to queue steering for workflow ${runId}: ${error instanceof Error ? error.message : String(error)}`);
567
+ }
568
+ const steering = await waitForSteeringAction({ asyncDir, sourceRunId: runId, requestId, timeoutMs: input.ackTimeoutMs ?? 3e3, signal: input.signal }) ?? { requestId, state: "pending", deliveryStatus: "queued", sourceRunId: runId, targets: input.index === void 0 ? [] : [{ index: input.index, state: "pending" }] };
569
+ const failed = steering.state === "failed" || steering.state === "partial";
570
+ return {
571
+ content: [{ type: "text", text: steeringReceipt(input.message, `Steering ${failed ? steering.state : steering.deliveryStatus === "delivered" ? "delivered" : "queued"} for workflow ${runId} (request ${requestId}).`) }],
572
+ ...failed ? { isError: true } : {},
573
+ details: { mode: "management", results: [], steering }
574
+ };
575
+ }
576
+ async function steerWorkflowForegroundTarget(input) {
577
+ const { control, sourceRunId } = input.target;
578
+ const activeIndexes = [...control.activeChildren?.keys() ?? []].sort((left, right) => left - right);
579
+ const index = input.index ?? (activeIndexes.length === 1 ? activeIndexes[0] : void 0);
580
+ if (index === void 0) {
581
+ return managementError(activeIndexes.length === 0 ? `Foreground run '${control.runId}' has no live child session.` : `Foreground run '${control.runId}' has ${activeIndexes.length} live child sessions; provide index.`);
582
+ }
583
+ const child = control.activeChildren?.get(index);
584
+ if (!child) return managementError(`Foreground run '${control.runId}' child ${index} is not live.`);
585
+ if (!child.steer) return managementError(`Foreground run '${control.runId}' child ${index} does not support steering.`);
586
+ const message = input.message.trim();
587
+ const requestId = randomUUID2();
588
+ const outcome = await child.steer({ message, ...input.mode && input.mode !== "steer" ? { mode: input.mode } : {} });
589
+ const target = outcome.state === "delivered" ? { index, state: "delivered", deliveredAt: Date.now() } : outcome.state === "queued" ? { index, state: "queued" } : { index, state: "failed", reason: outcome.reason };
590
+ const steering = {
591
+ requestId,
592
+ state: outcome.state === "delivered" ? "delivered" : outcome.state === "failed" ? "failed" : "pending",
593
+ deliveryStatus: outcome.state === "delivered" ? "delivered" : "queued",
594
+ sourceRunId,
595
+ targets: [target]
596
+ };
597
+ if (outcome.state === "delivered") {
598
+ return { content: [{ type: "text", text: steeringReceipt(message, `Steering delivered for foreground run ${control.runId} (request ${requestId}).`) }], details: { mode: "management", results: [], steering } };
599
+ }
600
+ if (outcome.state === "queued") {
601
+ return { content: [{ type: "text", text: steeringReceipt(message, `Steering queued for foreground run ${control.runId} (request ${requestId}).`) }], details: { mode: "management", results: [], steering } };
602
+ }
603
+ return { content: [{ type: "text", text: steeringReceipt(message, `Steering failed for foreground run ${control.runId} (request ${requestId}): ${outcome.reason ?? "unknown error"}`) }], isError: true, details: { mode: "management", results: [], steering } };
604
+ }
605
+
606
+ // src/tui/fleet-transcript.ts
607
+ import * as fs3 from "node:fs";
608
+ import * as path4 from "node:path";
609
+ import { getLanguageFromPath, highlightCode } from "@earendil-works/pi-coding-agent";
610
+ import { Markdown, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
611
+ var DEFAULT_MAX_RECORDS = 240;
612
+ var DEFAULT_MAX_BYTES = 2 * 1024 * 1024;
613
+ var MAX_MESSAGE_CHARS = 64 * 1024;
614
+ var TOOL_PREVIEW_LINES = 7;
615
+ function sanitizeJsonDisplayValue(value) {
616
+ if (typeof value === "string") {
617
+ const safe = safeTerminalText(value);
618
+ return { value: safe, changed: safe !== value };
619
+ }
620
+ if (Array.isArray(value)) {
621
+ const sanitized = value.map(sanitizeJsonDisplayValue);
622
+ return {
623
+ value: sanitized.map((entry) => entry.value),
624
+ changed: sanitized.some((entry) => entry.changed)
625
+ };
626
+ }
627
+ if (value && typeof value === "object") {
628
+ let changed = false;
629
+ const sanitized = /* @__PURE__ */ Object.create(null);
630
+ for (const [key, nested] of Object.entries(value)) {
631
+ const safeKey = safeTerminalText(key);
632
+ const safeValue = sanitizeJsonDisplayValue(nested);
633
+ sanitized[safeKey] = safeValue.value;
634
+ changed ||= safeKey !== key || safeValue.changed;
635
+ }
636
+ return { value: changed ? sanitized : value, changed };
637
+ }
638
+ return { value, changed: false };
639
+ }
640
+ function safeToolArgsPayload(payload) {
641
+ try {
642
+ const sanitized = sanitizeJsonDisplayValue(JSON.parse(payload));
643
+ return sanitized.changed ? JSON.stringify(sanitized.value) : safeTerminalText(payload);
644
+ } catch {
645
+ return safeTerminalText(payload);
646
+ }
647
+ }
648
+ function objectValue(value) {
649
+ return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
650
+ }
651
+ function stringValue(value) {
652
+ return typeof value === "string" && value.trim() ? value : void 0;
653
+ }
654
+ function numberValue(value) {
655
+ return typeof value === "number" && Number.isFinite(value) ? value : void 0;
656
+ }
657
+ function pathWithin(base, candidate) {
658
+ const resolvedBase = path4.resolve(base);
659
+ const resolvedCandidate = path4.resolve(candidate);
660
+ return resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path4.sep}`);
661
+ }
662
+ function errorMessage(error) {
663
+ return error instanceof Error ? error.message : String(error);
664
+ }
665
+ function isNotFoundError(error) {
666
+ return Boolean(objectValue(error)?.code === "ENOENT");
667
+ }
668
+ function validateTranscriptPath(filePath, trustedRoots, trustedFiles = [], trustedFileRoot) {
669
+ if (trustedRoots.length === 0 && (!trustedFileRoot || trustedFiles.length === 0)) return { warning: `Transcript preview has no trusted root: ${filePath}` };
670
+ const resolvedPath = path4.resolve(filePath);
671
+ const recordedCandidate = trustedFileRoot && pathWithin(trustedFileRoot, resolvedPath) && trustedFiles.some((file) => path4.resolve(file) === resolvedPath);
672
+ if (!trustedRoots.some((root) => pathWithin(root, resolvedPath)) && !recordedCandidate) {
673
+ return { warning: `Transcript is outside trusted roots: ${filePath}` };
674
+ }
675
+ let stat;
676
+ try {
677
+ stat = fs3.lstatSync(resolvedPath);
678
+ } catch (error) {
679
+ if (isNotFoundError(error)) return {};
680
+ return { warning: `Transcript could not be inspected: ${errorMessage(error)}` };
681
+ }
682
+ if (stat.isSymbolicLink()) return { warning: `Transcript preview refused a symlink: ${filePath}` };
683
+ if (!stat.isFile()) return { warning: `Transcript path is not a file: ${filePath}` };
684
+ try {
685
+ const realPath = fs3.realpathSync(resolvedPath);
686
+ const realRoots = trustedRoots.filter((root) => fs3.existsSync(root)).map((root) => fs3.realpathSync(root));
687
+ if (!realRoots.some((root) => pathWithin(root, realPath)) && !isTrustedRecordedSessionFile(realPath, trustedFiles, trustedFileRoot)) {
688
+ return { warning: `Transcript resolves outside trusted roots: ${filePath}` };
689
+ }
690
+ return { resolvedPath: realPath };
691
+ } catch (error) {
692
+ return { warning: `Transcript path could not be resolved: ${errorMessage(error)}` };
693
+ }
694
+ }
695
+ function isCompleteRecord(line) {
696
+ if (!line?.trim()) return false;
697
+ try {
698
+ return objectValue(JSON.parse(line)) !== void 0;
699
+ } catch {
700
+ return false;
701
+ }
702
+ }
703
+ function readTailLines(filePath, maxBytes) {
704
+ let fd;
705
+ try {
706
+ const noFollow = typeof fs3.constants.O_NOFOLLOW === "number" ? fs3.constants.O_NOFOLLOW : 0;
707
+ fd = fs3.openSync(filePath, fs3.constants.O_RDONLY | noFollow);
708
+ const stat = fs3.fstatSync(fd);
709
+ if (!stat.isFile()) return { lines: [], truncated: false, warning: `Transcript path is not a file: ${filePath}` };
710
+ if (stat.size === 0) return { lines: [], truncated: false };
711
+ const bytesToRead = Math.min(stat.size, maxBytes);
712
+ const start = stat.size - bytesToRead;
713
+ const buffer = Buffer.alloc(bytesToRead);
714
+ const bytesRead = fs3.readSync(fd, buffer, 0, bytesToRead, start);
715
+ const content = buffer.subarray(0, bytesRead).toString("utf-8");
716
+ const endsWithNewline = content.endsWith("\n");
717
+ let lines = content.split(/\r?\n/);
718
+ if (start > 0 && lines.length > 0) lines = lines.slice(1);
719
+ if (lines.at(-1) === "") lines = lines.slice(0, -1);
720
+ else if (!endsWithNewline && !isCompleteRecord(lines.at(-1))) lines = lines.slice(0, -1);
721
+ return { lines, truncated: start > 0 };
722
+ } catch (error) {
723
+ return { lines: [], truncated: false, warning: `Transcript could not be read: ${errorMessage(error)}` };
724
+ } finally {
725
+ if (fd !== void 0) fs3.closeSync(fd);
726
+ }
727
+ }
728
+ function clipMessage(text) {
729
+ if (text.length <= MAX_MESSAGE_CHARS) return text;
730
+ return `${text.slice(0, MAX_MESSAGE_CHARS)}
731
+
732
+ \u2026 message truncated`;
733
+ }
734
+ function safeTranscriptEvent(event) {
735
+ if (event.kind === "assistant") {
736
+ return {
737
+ ...event,
738
+ text: safeTerminalText(event.text),
739
+ ...event.model ? { model: safeTerminalText(event.model) } : {}
740
+ };
741
+ }
742
+ if (event.kind === "user" || event.kind === "notice") {
743
+ return { ...event, text: safeTerminalText(event.text) };
744
+ }
745
+ return {
746
+ ...event,
747
+ name: safeTerminalText(event.name),
748
+ ...event.args !== void 0 ? { args: safeTerminalText(event.args) } : {},
749
+ ...event.argsPayload !== void 0 ? { argsPayload: safeToolArgsPayload(event.argsPayload) } : {},
750
+ ...event.output !== void 0 ? { output: safeTerminalText(event.output) } : {},
751
+ ...event.error !== void 0 ? { error: safeTerminalText(event.error) } : {}
752
+ };
753
+ }
754
+ function findTool(events, toolCallId, name) {
755
+ if (toolCallId) {
756
+ for (let index = events.length - 1; index >= 0; index--) {
757
+ const event = events[index];
758
+ if (event?.kind === "tool" && event.toolCallId === toolCallId) return event;
759
+ }
760
+ return void 0;
761
+ }
762
+ for (let index = events.length - 1; index >= 0; index--) {
763
+ const event = events[index];
764
+ if (event?.kind !== "tool") continue;
765
+ const tool = event;
766
+ if ((!name || tool.name === name) && !tool.resultSeen) return tool;
767
+ }
768
+ return void 0;
769
+ }
770
+ function appendTextEvent(events, kind, text, metadata) {
771
+ const clipped = clipMessage(text.trim());
772
+ if (!clipped) return;
773
+ const previous = events.at(-1);
774
+ if (previous?.kind === kind && previous.text === clipped) return;
775
+ events.push({ kind, text: clipped, ...metadata });
776
+ }
777
+ function parseTranscriptLines(lines, conversationStarted = false) {
778
+ const events = [];
779
+ let malformed = 0;
780
+ let explicitTruncation = false;
781
+ let assistantSeen = conversationStarted;
782
+ for (const line of lines) {
783
+ if (!line.trim()) continue;
784
+ let record;
785
+ try {
786
+ record = objectValue(JSON.parse(line));
787
+ } catch {
788
+ malformed++;
789
+ continue;
790
+ }
791
+ if (!record) {
792
+ malformed++;
793
+ continue;
794
+ }
795
+ const recordType = stringValue(record.recordType);
796
+ const timestamp = numberValue(record.ts);
797
+ if (recordType === "truncated") {
798
+ explicitTruncation = true;
799
+ continue;
800
+ }
801
+ if (recordType === "tool_start") {
802
+ const name = stringValue(record.toolName) ?? "tool";
803
+ events.push({
804
+ kind: "tool",
805
+ ...stringValue(record.toolCallId) ? { toolCallId: stringValue(record.toolCallId) } : {},
806
+ name,
807
+ ...stringValue(record.argsPreview) ? { args: stringValue(record.argsPreview) } : {},
808
+ ...stringValue(record.argsPayload) ? { argsPayload: stringValue(record.argsPayload) } : {},
809
+ status: "running",
810
+ ...timestamp !== void 0 ? { timestamp, startedAt: timestamp } : {}
811
+ });
812
+ continue;
813
+ }
814
+ if (recordType === "tool_end") {
815
+ const tool = findTool(events, stringValue(record.toolCallId), stringValue(record.toolName));
816
+ if (tool && !tool.resultSeen) tool.status = record.isError === true ? "error" : "complete";
817
+ if (tool && timestamp !== void 0 && tool.endedAt === void 0) tool.endedAt = timestamp;
818
+ continue;
819
+ }
820
+ if (recordType === "stderr") {
821
+ const text2 = stringValue(record.text);
822
+ if (text2) events.push({ kind: "notice", text: clipMessage(text2), tone: "error", ...timestamp !== void 0 ? { timestamp } : {} });
823
+ continue;
824
+ }
825
+ if (recordType !== "message") continue;
826
+ const message = objectValue(record.message);
827
+ const role = stringValue(record.role) ?? stringValue(message?.role);
828
+ const text = stringValue(record.text) ?? stringValue(message?.text) ?? stringValue(message?.content);
829
+ if (role === "toolResult" || role === "tool_result") {
830
+ const toolCallId = stringValue(record.toolCallId) ?? stringValue(message?.toolCallId);
831
+ const name = stringValue(record.toolName) ?? stringValue(message?.toolName) ?? "tool";
832
+ const failed = record.isError === true || message?.isError === true;
833
+ let tool = findTool(events, toolCallId, name);
834
+ if (!tool) {
835
+ tool = {
836
+ kind: "tool",
837
+ ...toolCallId ? { toolCallId } : {},
838
+ name,
839
+ status: failed ? "error" : "complete",
840
+ ...timestamp !== void 0 ? { timestamp } : {}
841
+ };
842
+ events.push(tool);
843
+ }
844
+ if (!tool.resultSeen) {
845
+ tool.resultSeen = true;
846
+ tool.status = failed ? "error" : "complete";
847
+ if (timestamp !== void 0 && tool.endedAt === void 0) tool.endedAt = timestamp;
848
+ if (text && (!failed || tool.output === void 0)) {
849
+ tool.output = clipMessage(text);
850
+ tool.outputTruncated = record.outputTruncated === true || text.includes("\u2026 payload truncated") || text.includes("[Showing lines");
851
+ }
852
+ if (failed && text) tool.error = clipMessage(text.split(/\r?\n/).find((candidate) => candidate.trim()) ?? text);
853
+ }
854
+ continue;
855
+ }
856
+ if (role === "assistant") {
857
+ assistantSeen = true;
858
+ const rawModel = stringValue(record.model) ?? stringValue(message?.model);
859
+ const provider = stringValue(message?.provider);
860
+ const model = rawModel && provider ? `${provider}/${rawModel}` : rawModel;
861
+ if (text) appendTextEvent(events, "assistant", text, {
862
+ ...model ? { model } : {},
863
+ ...timestamp !== void 0 ? { timestamp } : {}
864
+ });
865
+ continue;
866
+ }
867
+ if (role === "user" && assistantSeen && text) {
868
+ appendTextEvent(events, "user", text, timestamp !== void 0 ? { timestamp } : {});
869
+ }
870
+ }
871
+ for (const event of events) {
872
+ if (event.kind === "tool") delete event.resultSeen;
873
+ }
874
+ return { events: events.map(safeTranscriptEvent), malformed, explicitTruncation };
875
+ }
876
+ function readFleetTranscript(filePath, options) {
877
+ const validated = validateTranscriptPath(filePath, options.trustedRoots, options.trustedFiles, options.trustedFileRoot);
878
+ if (!validated.resolvedPath) {
879
+ return { path: filePath, events: [], truncated: false, readFailed: true, ...validated.warning ? { warning: safeTerminalText(validated.warning) } : {} };
880
+ }
881
+ const maxRecords = Math.max(1, options.maxRecords ?? DEFAULT_MAX_RECORDS);
882
+ const tail = readTailLines(validated.resolvedPath, Math.max(1024, options.maxBytes ?? DEFAULT_MAX_BYTES));
883
+ const recordsOmitted = tail.truncated || tail.lines.length > maxRecords;
884
+ const selectedLines = tail.lines.slice(-maxRecords);
885
+ const parsed = parseTranscriptLines(selectedLines, recordsOmitted);
886
+ const warnings = [
887
+ tail.warning,
888
+ parsed.malformed > 0 ? `Skipped ${parsed.malformed} malformed transcript record${parsed.malformed === 1 ? "" : "s"}.` : void 0
889
+ ].filter((value) => Boolean(value));
890
+ return {
891
+ path: filePath,
892
+ events: parsed.events,
893
+ truncated: tail.truncated || tail.lines.length > maxRecords || parsed.explicitTruncation,
894
+ ...tail.warning ? { readFailed: true } : {},
895
+ ...warnings.length ? { warning: safeTerminalText(warnings.join(" ")) } : {}
896
+ };
897
+ }
898
+ function readTranscriptRecords(filePath, options) {
899
+ const validated = validateTranscriptPath(filePath, options.trustedRoots);
900
+ if (!validated.resolvedPath) {
901
+ return { records: [], truncated: false, readFailed: true, ...validated.warning ? { warning: safeTerminalText(validated.warning) } : {} };
902
+ }
903
+ const maxRecords = Math.max(1, options.maxRecords ?? DEFAULT_MAX_RECORDS);
904
+ const tail = readTailLines(validated.resolvedPath, Math.max(1024, options.maxBytes ?? DEFAULT_MAX_BYTES));
905
+ const selected = tail.lines.slice(-maxRecords);
906
+ const records = [];
907
+ let malformed = 0;
908
+ for (const line of selected) {
909
+ if (!line.trim()) continue;
910
+ try {
911
+ const parsed = JSON.parse(line);
912
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
913
+ records.push(parsed);
914
+ } else {
915
+ malformed++;
916
+ }
917
+ } catch {
918
+ malformed++;
919
+ }
920
+ }
921
+ const warnings = [
922
+ tail.warning,
923
+ malformed > 0 ? `Skipped ${malformed} malformed transcript record${malformed === 1 ? "" : "s"}.` : void 0
924
+ ].filter((value) => Boolean(value));
925
+ return {
926
+ records,
927
+ ...tail.warning ? { readFailed: true } : {},
928
+ truncated: tail.truncated || tail.lines.length > maxRecords,
929
+ ...warnings.length ? { warning: safeTerminalText(warnings.join(" ")) } : {}
930
+ };
931
+ }
932
+ function statusGlyph(event, theme) {
933
+ if (event.status === "running") return theme.fg("warning", "\u25CF");
934
+ if (event.status === "error") return theme.fg("error", "\u2717");
935
+ return theme.fg("success", "\u2713");
936
+ }
937
+ function jsonScalar(value) {
938
+ if (typeof value === "string" && value.trim()) return value;
939
+ if (typeof value === "number" || typeof value === "boolean") return String(value);
940
+ return void 0;
941
+ }
942
+ function parseToolArgs(event) {
943
+ if (!event.argsPayload) return void 0;
944
+ try {
945
+ return objectValue(JSON.parse(event.argsPayload));
946
+ } catch {
947
+ return void 0;
948
+ }
949
+ }
950
+ function toolDuration(event) {
951
+ if (event.startedAt === void 0 || event.endedAt === void 0) return void 0;
952
+ return `${((event.endedAt - event.startedAt) / 1e3).toFixed(1)}s`;
953
+ }
954
+ function renderExpandedTool(event, width, theme) {
955
+ const lines = [];
956
+ const args = parseToolArgs(event);
957
+ const glyph = statusGlyph(event, theme);
958
+ const output = event.output ?? event.error;
959
+ const outputColor = event.status === "error" ? "error" : "toolOutput";
960
+ if (event.name === "bash") {
961
+ const command = jsonScalar(args?.command) ?? event.args ?? "(unknown command)";
962
+ lines.push(railLine(`${glyph} ${theme.fg("toolTitle", theme.bold(`$ ${command}`))}`, width, theme));
963
+ if (output) {
964
+ for (const outputLine of output.replace(/\s+$/, "").split(/\r?\n/)) {
965
+ for (const wrapped of renderWrapped(theme.fg(outputColor, outputLine), Math.max(1, width - 4))) {
966
+ lines.push(railLine(` ${wrapped}`, width, theme));
967
+ }
968
+ }
969
+ }
970
+ const duration = toolDuration(event);
971
+ if (duration) lines.push(railLine(theme.fg("dim", ` Took ${duration}`), width, theme));
972
+ return lines;
973
+ }
974
+ if (event.name === "read") {
975
+ const filePath = jsonScalar(args?.path ?? args?.file_path);
976
+ const language = filePath ? getLanguageFromPath(filePath) : void 0;
977
+ const rendered = !output ? [] : event.status === "error" ? output.split("\n").map((line) => theme.fg("error", line)) : language ? highlightCode(output, language) : output.split("\n");
978
+ lines.push(railLine(`${glyph} ${theme.fg("toolTitle", theme.bold(`read ${filePath ?? event.args ?? ""}`))}`, width, theme));
979
+ for (const line of rendered) {
980
+ for (const wrapped of renderWrapped(line, Math.max(1, width - 4))) lines.push(railLine(` ${wrapped}`, width, theme));
981
+ }
982
+ return lines;
983
+ }
984
+ lines.push(railLine(`${glyph} ${theme.fg("toolTitle", theme.bold(event.name))}`, width, theme));
985
+ if (event.argsPayload) {
986
+ lines.push(railLine(theme.fg("dim", " args"), width, theme));
987
+ for (const argLine of event.argsPayload.split(/\r?\n/)) {
988
+ for (const wrapped of renderWrapped(theme.fg("muted", argLine), Math.max(1, width - 4))) lines.push(railLine(` ${wrapped}`, width, theme));
989
+ }
990
+ }
991
+ if (output) {
992
+ lines.push(railLine(theme.fg(event.status === "error" ? "error" : "dim", event.status === "error" ? " error" : " output"), width, theme));
993
+ for (const outputLine of output.split(/\r?\n/)) {
994
+ for (const wrapped of renderWrapped(theme.fg(outputColor, outputLine), Math.max(1, width - 4))) lines.push(railLine(` ${wrapped}`, width, theme));
995
+ }
996
+ }
997
+ return lines;
998
+ }
999
+ function bounded(text, width) {
1000
+ return truncateToWidth(text, Math.max(0, width));
1001
+ }
1002
+ function railLine(content, width, theme) {
1003
+ return bounded(`${theme.fg("borderMuted", "\u2502")} ${content}`, width);
1004
+ }
1005
+ function renderWrapped(text, width) {
1006
+ return wrapTextWithAnsi(text, Math.max(1, width));
1007
+ }
1008
+ function renderFleetTranscript(transcript, width, theme, markdownTheme, options = {}) {
1009
+ if (width <= 0) return [];
1010
+ const lines = [];
1011
+ if (transcript.truncated) lines.push(bounded(theme.fg("dim", "\u2191 Earlier activity omitted"), width));
1012
+ if (transcript.warning) {
1013
+ for (const line of renderWrapped(safeTerminalText(transcript.warning), Math.max(1, width - 2))) {
1014
+ lines.push(bounded(`${theme.fg("warning", "!")} ${theme.fg("warning", line)}`, width));
1015
+ }
1016
+ }
1017
+ for (const rawEvent of transcript.events) {
1018
+ const event = safeTranscriptEvent(rawEvent);
1019
+ if (event.kind === "tool") {
1020
+ if (options.expandedTools && (event.output || event.argsPayload || event.error)) {
1021
+ lines.push(...renderExpandedTool(event, width, theme));
1022
+ lines.push(railLine(theme.fg("dim", " x to collapse"), width, theme));
1023
+ continue;
1024
+ }
1025
+ const title = theme.fg("toolTitle", theme.bold(event.name));
1026
+ const args = event.args ? ` ${theme.fg("dim", event.args)}` : "";
1027
+ const suffix = event.status === "running" ? theme.fg("warning", " running") : "";
1028
+ lines.push(bounded(`${theme.fg("borderMuted", "\u251C\u2500")} ${statusGlyph(event, theme)} ${title}${args}${suffix}`, width));
1029
+ if (event.output && event.status !== "error" && event.name === "bash") {
1030
+ const outputLines = event.output.replace(/\s+$/, "").split(/\r?\n/);
1031
+ const visible = outputLines.slice(-TOOL_PREVIEW_LINES);
1032
+ const hidden = Math.max(0, outputLines.length - visible.length);
1033
+ for (const outputLine of visible) {
1034
+ for (const wrapped of renderWrapped(theme.fg("toolOutput", outputLine), Math.max(1, width - 4))) {
1035
+ lines.push(railLine(` ${wrapped}`, width, theme));
1036
+ }
1037
+ }
1038
+ if (hidden > 0) lines.push(railLine(theme.fg("dim", ` \u2026 ${hidden} earlier lines \xB7 x to expand`), width, theme));
1039
+ const duration = toolDuration(event);
1040
+ lines.push(railLine(theme.fg("dim", ` Took${duration ? ` ${duration}` : ""}`), width, theme));
1041
+ } else if (event.output && event.status !== "error") {
1042
+ const summary = truncateToWidth(event.output.replace(/\s+/g, " ").trim(), Math.max(1, width - 18), "\u2026");
1043
+ if (summary) lines.push(railLine(theme.fg("dim", ` ${summary} \xB7 x to expand`), width, theme));
1044
+ }
1045
+ if (event.error) {
1046
+ for (const errorLine of renderWrapped(event.error, Math.max(1, width - 4))) {
1047
+ lines.push(railLine(theme.fg("error", ` ${errorLine}`), width, theme));
1048
+ }
1049
+ }
1050
+ continue;
1051
+ }
1052
+ if (event.kind === "notice") {
1053
+ const color = event.tone === "error" ? "error" : event.tone === "warning" ? "warning" : "dim";
1054
+ for (const noticeLine of renderWrapped(event.text, Math.max(1, width - 2))) {
1055
+ lines.push(railLine(theme.fg(color, noticeLine), width, theme));
1056
+ }
1057
+ continue;
1058
+ }
1059
+ const assistant = event.kind === "assistant";
1060
+ const label = assistant ? "Assistant" : "Supervisor";
1061
+ const marker = assistant ? theme.fg("accent", "\u25C6") : theme.fg("warning", "\u25C7");
1062
+ const model = assistant && event.model ? theme.fg("dim", ` \xB7 ${event.model}`) : "";
1063
+ lines.push(bounded(`${marker} ${theme.bold(label)}${model}`, width));
1064
+ if (assistant) {
1065
+ const rendered = new Markdown(event.text, 0, 0, markdownTheme).render(Math.max(1, width - 2));
1066
+ for (const markdownLine of rendered) lines.push(railLine(markdownLine, width, theme));
1067
+ } else {
1068
+ for (const userLine of renderWrapped(event.text, Math.max(1, width - 2))) {
1069
+ lines.push(railLine(userLine, width, theme));
1070
+ }
1071
+ }
1072
+ lines.push(theme.fg("borderMuted", "\u2502"));
1073
+ }
1074
+ while (lines.length > 0 && visibleWidth(lines.at(-1) ?? "") === 1) lines.pop();
1075
+ return lines;
1076
+ }
1077
+
1078
+ // src/inspectors/types.ts
1079
+ var INSPECTOR_ACTIONS = ["inspector.open", "inspector.command", "inspector.status", "inspector.close"];
1080
+
1081
+ // src/inspectors/actions.ts
1082
+ import * as fs4 from "node:fs";
1083
+ import * as path5 from "node:path";
1084
+ import { fileURLToPath } from "node:url";
1085
+
1086
+ // src/inspectors/session-roots-codec.ts
1087
+ function encodeSessionRoots(roots) {
1088
+ return Buffer.from(JSON.stringify(roots), "utf-8").toString("base64");
1089
+ }
1090
+
1091
+ // src/inspectors/actions.ts
1092
+ var INSPECTOR_LEASE_WAIT_MS = 3e4;
1093
+ function result(text, isError = false) {
1094
+ const response = {
1095
+ content: [{ type: "text", text }],
1096
+ details: { mode: "management", results: [] }
1097
+ };
1098
+ if (isError) response.isError = true;
1099
+ return response;
1100
+ }
1101
+ function pathWithin2(base, candidate) {
1102
+ const resolvedBase = path5.resolve(base);
1103
+ const resolvedCandidate = path5.resolve(candidate);
1104
+ return resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path5.sep}`);
1105
+ }
1106
+ function trustedDir(dir, deps) {
1107
+ try {
1108
+ if (fs4.lstatSync(dir).isSymbolicLink() || !fs4.statSync(dir).isDirectory()) return false;
1109
+ const real = fs4.realpathSync(dir);
1110
+ if ([...deps.state?.asyncJobs.values() ?? [], ...deps.state?.fleetJobs?.values() ?? []].some((job) => {
1111
+ try {
1112
+ return fs4.realpathSync(job.asyncDir) === real;
1113
+ } catch {
1114
+ return false;
1115
+ }
1116
+ })) return true;
1117
+ const root = deps.asyncDirRoot ?? DIRS.async;
1118
+ return fs4.existsSync(root) && pathWithin2(root, dir) && pathWithin2(fs4.realpathSync(root), real);
1119
+ } catch {
1120
+ return false;
1121
+ }
1122
+ }
1123
+ function resolveTarget(params, deps) {
1124
+ const requested = params.id ?? params.runId;
1125
+ let runId;
1126
+ let asyncDir;
1127
+ if (params.dir) {
1128
+ asyncDir = path5.resolve(params.dir);
1129
+ if (!trustedDir(asyncDir, deps)) return { error: `Async run directory '${asyncDir}' is outside trusted run roots.` };
1130
+ const status2 = readStatus(asyncDir);
1131
+ if (!status2) return { error: `No async run status found in '${asyncDir}'.` };
1132
+ if (requested && requested !== status2.runId && !status2.runId.startsWith(requested)) return { error: `Run '${requested}' does not match status run '${status2.runId}'.` };
1133
+ runId = status2.runId;
1134
+ } else {
1135
+ if (!requested) return { error: "Inspector actions require id or dir." };
1136
+ try {
1137
+ const found = resolveSubagentRunId(requested, { state: deps.state, asyncDirRoot: deps.asyncDirRoot ?? DIRS.async, resultsDir: deps.resultsDir ?? DIRS.results });
1138
+ if (!found) return { error: `No subagent run found for '${requested}'.` };
1139
+ if (found.kind !== "async" || !found.location.asyncDir) return { error: `Run '${found.id}' is not an inspectable async run with lifecycle artifacts.` };
1140
+ runId = found.id;
1141
+ asyncDir = found.location.asyncDir;
1142
+ } catch (cause) {
1143
+ return { error: cause instanceof Error ? cause.message : String(cause) };
1144
+ }
1145
+ }
1146
+ const status = readStatus(asyncDir);
1147
+ if (!status) return { error: `No lifecycle status exists for async run '${runId}'.` };
1148
+ if (params.index !== void 0 && (params.index < 0 || params.index >= (status.steps?.length ?? 0))) return { error: `Async run '${runId}' has ${status.steps?.length ?? 0} children. Index ${params.index} is out of range.` };
1149
+ const target = { runId, asyncDir, status: { cwd: status.cwd, state: status.state, steps: status.steps } };
1150
+ if (params.index !== void 0) target.index = params.index;
1151
+ return target;
1152
+ }
1153
+ function missionFor(target, deps) {
1154
+ try {
1155
+ const binding = readMissionBinding(target.asyncDir);
1156
+ if (binding) return { id: binding.missionId, path: missionRecordPath(binding.location, binding.missionId) };
1157
+ const location = resolveMissionStoreLocation(deps.missions ? { projectRoot: deps.cwd, config: deps.missions } : { projectRoot: deps.cwd });
1158
+ const mission = listMissions(location).records.find((record) => record.runs.some((run) => run.runId === target.runId));
1159
+ return mission ? { id: mission.id, path: missionRecordPath(location, mission.id) } : void 0;
1160
+ } catch {
1161
+ return void 0;
1162
+ }
1163
+ }
1164
+ function launchFor(target, deps) {
1165
+ const mission = missionFor(target, deps);
1166
+ const runnerPath = deps.runnerPath ?? fileURLToPath(new URL("../../inspector-runner.mjs", new URL("../src/inspectors/actions.js", import.meta.url).href));
1167
+ const job = deps.state?.asyncJobs.get(target.runId) ?? deps.state?.fleetJobs?.get(target.runId);
1168
+ const sessionRoots = [.../* @__PURE__ */ new Set([...deps.sessionRoots ?? deps.state?.trustedSessionRoots ?? [], ...job?.sessionRoot ? [job.sessionRoot] : []])];
1169
+ const allowSteer = resolveAuthorityDecision({ action: "steerRun", policy: deps.authorityPolicy }) === "auto";
1170
+ const allowStop = resolveAuthorityDecision({ action: "stopRun", policy: deps.authorityPolicy }) === "auto";
1171
+ const argv = [runnerPath, "--async-dir", target.asyncDir, "--run-id", target.runId, "--allow-steer", String(allowSteer), "--allow-stop", String(allowStop), "--session-roots", encodeSessionRoots(sessionRoots)];
1172
+ if (target.index !== void 0) argv.push("--index", String(target.index));
1173
+ if (mission) argv.push("--mission-path", mission.path);
1174
+ const executable = resolveNodeExecutable();
1175
+ const launch = { executable, argv, displayCommand: formatShellCommand(executable, argv), allowSteer, allowStop, sessionRoots };
1176
+ if (mission) launch.mission = mission;
1177
+ return launch;
1178
+ }
1179
+ async function handleInspectorAction(action, params, deps) {
1180
+ const target = resolveTarget(params, deps);
1181
+ if ("error" in target) return result(target.error, true);
1182
+ const context = {
1183
+ cwd: deps.cwd,
1184
+ signal: deps.signal,
1185
+ env: deps.env ?? process.env,
1186
+ target
1187
+ };
1188
+ if (deps.now) context.now = deps.now;
1189
+ if (action === "inspector.command") return result(launchFor(target, deps).displayCommand);
1190
+ const plugins = deps.plugins ?? [];
1191
+ if (action === "inspector.status") {
1192
+ const owner = plugins.find((plugin) => plugin.owns(context));
1193
+ if (!owner) return result(`No inspector plugin owns this binding for async run ${target.runId}.`);
1194
+ return owner.status ? owner.status(context) : result(`Inspector plugin '${owner.name}' does not support status for async run ${target.runId}.`, true);
1195
+ }
1196
+ const label = target.index === void 0 ? "" : ` child ${target.index}`;
1197
+ const lockPath = path5.join(fs4.realpathSync.native(target.asyncDir), `inspector-${target.index ?? "root"}.lock`);
1198
+ const deadline = Date.now() + (deps.leaseWaitMs ?? INSPECTOR_LEASE_WAIT_MS);
1199
+ let release = tryLease(lockPath);
1200
+ while (!release) {
1201
+ if (deps.signal?.aborted) return result(`Inspector ${action} for async run ${target.runId}${label} was cancelled while waiting for another inspector open or close to finish.`, true);
1202
+ if (Date.now() >= deadline) return result(`Another inspector open or close for async run ${target.runId}${label} is still in progress. Try again when it finishes.`, true);
1203
+ await new Promise((resolve3) => setTimeout(resolve3, 50));
1204
+ release = tryLease(lockPath);
1205
+ }
1206
+ try {
1207
+ if (deps.signal?.aborted) return result(`Inspector ${action} for async run ${target.runId}${label} was cancelled while waiting for another inspector open or close to finish.`, true);
1208
+ if (action === "inspector.open") {
1209
+ for (const plugin of plugins) {
1210
+ if (await plugin.available(context)) return await plugin.open(context, launchFor(target, deps), params);
1211
+ }
1212
+ return result("No inspector plugin is available. Start a supported inspector host, or use inspector.command for a standalone command.", true);
1213
+ }
1214
+ const owner = plugins.find((plugin) => plugin.owns(context));
1215
+ if (!owner) return result(`No inspector plugin owns this binding for async run ${target.runId}.`);
1216
+ return owner.close ? await owner.close(context) : result(`Inspector plugin '${owner.name}' does not support close for async run ${target.runId}.`, true);
1217
+ } finally {
1218
+ release();
1219
+ }
1220
+ }
1221
+
1222
+ // src/runs/foreground/prompt-audit.ts
1223
+ var livePrompts = /* @__PURE__ */ new WeakMap();
1224
+ function fullModelId(model) {
1225
+ return `${model.provider}/${model.id}`;
1226
+ }
1227
+ function textContent(value) {
1228
+ if (typeof value === "string") return value;
1229
+ if (!Array.isArray(value)) return "";
1230
+ return value.map((item) => item && typeof item === "object" && item.type === "text" ? String(item.text ?? "") : "").join("");
1231
+ }
1232
+ function finalAssistantText(agent) {
1233
+ for (let index = agent.state.messages.length - 1; index >= 0; index--) {
1234
+ const message = agent.state.messages[index];
1235
+ if (message && typeof message === "object" && message.role === "assistant") {
1236
+ return textContent(message.content).trim();
1237
+ }
1238
+ }
1239
+ return "";
1240
+ }
1241
+ async function resolveRewriteAuth(ctx, model) {
1242
+ const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
1243
+ if (auth.ok === false) throw new Error(`Prompt redo model auth failed for ${fullModelId(model)}: ${auth.error}`);
1244
+ return {
1245
+ ...auth.apiKey ? { apiKey: auth.apiKey } : {},
1246
+ ...auth.headers ? { headers: auth.headers } : {},
1247
+ ...auth.env ? { env: auth.env } : {}
1248
+ };
1249
+ }
1250
+ async function rewritePromptWithGuidance(input) {
1251
+ const model = input.ctx.model;
1252
+ if (!model) throw new Error("Prompt redo needs the current session model to rewrite the authored task.");
1253
+ const [{ Agent }, { convertToLlm }] = await Promise.all([
1254
+ import("@earendil-works/pi-agent-core"),
1255
+ import("@earendil-works/pi-coding-agent")
1256
+ ]);
1257
+ const auth = await resolveRewriteAuth(input.ctx, model);
1258
+ const baseStreamFn = input.streamFn ?? ((nextModel, context, streamOptions) => input.ctx.modelRegistry.streamSimple(nextModel, context, streamOptions));
1259
+ const sessionId = input.ctx.sessionManager.getSessionId();
1260
+ const streamFn = (nextModel, context, streamOptions) => baseStreamFn(nextModel, context, {
1261
+ ...streamOptions,
1262
+ ...auth.apiKey ? { apiKey: auth.apiKey } : {},
1263
+ env: auth.env || streamOptions?.env ? { ...auth.env ?? {}, ...streamOptions?.env ?? {} } : void 0,
1264
+ headers: { ...opencodeSessionHeaders(nextModel, sessionId), ...streamOptions?.headers ?? {}, ...auth.headers ?? {} }
1265
+ });
1266
+ const ctxThinking = input.ctx.getThinkingLevel?.();
1267
+ const agent = new Agent({
1268
+ initialState: {
1269
+ systemPrompt: [
1270
+ "Rewrite one subagent authored task from Prompt Audit context.",
1271
+ "Return only the revised authored task text.",
1272
+ "Do not add Markdown fences, explanations, labels, or commentary.",
1273
+ "Preserve the original intent unless the guidance explicitly changes it.",
1274
+ "Do not include runtime additions unless they are needed as ordinary task context."
1275
+ ].join("\n"),
1276
+ model,
1277
+ thinkingLevel: ctxThinking ?? "off",
1278
+ tools: []
1279
+ },
1280
+ convertToLlm,
1281
+ ...agentStreamOptions(streamFn),
1282
+ getApiKey: (providerName) => providerName === model.provider ? auth.apiKey : void 0,
1283
+ toolExecution: "sequential"
1284
+ });
1285
+ const abort = () => agent.abort();
1286
+ input.ctx.signal?.addEventListener("abort", abort, { once: true });
1287
+ input.signal?.addEventListener("abort", abort, { once: true });
1288
+ try {
1289
+ await agent.prompt([
1290
+ "Guidance from the human:",
1291
+ input.guidance.trim(),
1292
+ "",
1293
+ "Authored task:",
1294
+ input.authoredTask,
1295
+ "",
1296
+ "Runtime additions for context only:",
1297
+ input.runtimeAdditions,
1298
+ "",
1299
+ "Final effective prompt for context only:",
1300
+ input.finalEffectivePrompt
1301
+ ].join("\n"));
1302
+ } finally {
1303
+ input.ctx.signal?.removeEventListener("abort", abort);
1304
+ input.signal?.removeEventListener("abort", abort);
1305
+ }
1306
+ const rewritten = finalAssistantText(agent);
1307
+ if (!rewritten) throw new Error("Prompt redo rewrite returned an empty prompt.");
1308
+ return rewritten;
1309
+ }
1310
+ function runtimeAdditions(authoredTask, effectivePrompt) {
1311
+ if (!authoredTask) return effectivePrompt;
1312
+ const authoredIndex = effectivePrompt.indexOf(authoredTask);
1313
+ if (authoredIndex < 0) return "(runtime additions unavailable)";
1314
+ const before = effectivePrompt.slice(0, authoredIndex).trim();
1315
+ const after = effectivePrompt.slice(authoredIndex + authoredTask.length).trim();
1316
+ return [before, after].filter(Boolean).join("\n\n") || "(none)";
1317
+ }
1318
+ function registerLivePromptAudit(control, index, authoredTask, effectivePrompt, metadata = {}) {
1319
+ let prompts = livePrompts.get(control);
1320
+ if (!prompts) {
1321
+ prompts = /* @__PURE__ */ new Map();
1322
+ livePrompts.set(control, prompts);
1323
+ }
1324
+ prompts.set(index, {
1325
+ authoredTask,
1326
+ runtimeAdditions: runtimeAdditions(authoredTask, effectivePrompt),
1327
+ finalEffectivePrompt: effectivePrompt,
1328
+ ...metadata.cwd ? { cwd: metadata.cwd } : {},
1329
+ ...metadata.outputPath ? { outputPath: metadata.outputPath } : {},
1330
+ ...metadata.rerun ? { rerun: metadata.rerun } : {}
1331
+ });
1332
+ }
1333
+ function updateLiveEffectivePrompt(control, index, effectivePrompt) {
1334
+ const prompt = livePrompts.get(control)?.get(index);
1335
+ if (!prompt) return;
1336
+ prompt.finalEffectivePrompt = effectivePrompt;
1337
+ prompt.runtimeAdditions = runtimeAdditions(prompt.authoredTask, effectivePrompt);
1338
+ }
1339
+ function getLivePromptAudit(control, index) {
1340
+ return livePrompts.get(control)?.get(index);
1341
+ }
1342
+ function removeLivePromptAudit(control, index) {
1343
+ const prompts = livePrompts.get(control);
1344
+ if (!prompts) return;
1345
+ prompts.delete(index);
1346
+ if (prompts.size === 0) livePrompts.delete(control);
1347
+ }
1348
+
1349
+ export {
1350
+ steeringReceipt,
1351
+ createSteeringStatus,
1352
+ steeringStatus,
1353
+ recordSteeringRequest,
1354
+ updateSteeringTarget,
1355
+ waitForSteeringAction,
1356
+ canQueueRetainedAsyncFollowUp,
1357
+ steerAsyncRun,
1358
+ workflowAsyncChildSteeringGuidance,
1359
+ resolveWorkflowForegroundSteeringTarget,
1360
+ steerWorkflowRun,
1361
+ steerWorkflowForegroundTarget,
1362
+ readFleetTranscript,
1363
+ readTranscriptRecords,
1364
+ renderFleetTranscript,
1365
+ INSPECTOR_ACTIONS,
1366
+ handleInspectorAction,
1367
+ rewritePromptWithGuidance,
1368
+ registerLivePromptAudit,
1369
+ updateLiveEffectivePrompt,
1370
+ getLivePromptAudit,
1371
+ removeLivePromptAudit
1372
+ };