@xzzpig/pi-subagents 0.22.0 → 0.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1138) hide show
  1. package/CHANGELOG.md +355 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3U633XDZ.js +749 -0
  14. package/bundle/chunk-4QFZZV3O.js +57 -0
  15. package/bundle/chunk-62OCY2S4.js +14 -0
  16. package/bundle/chunk-6BJUEES3.js +276 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-BGIYHF2W.js +138 -0
  19. package/bundle/chunk-CTPAE36Y.js +94 -0
  20. package/bundle/chunk-D4EHT5SJ.js +14 -0
  21. package/bundle/chunk-ED55MIC2.js +1681 -0
  22. package/bundle/chunk-EUPJB4S7.js +5503 -0
  23. package/bundle/chunk-FG6SQJAR.js +940 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-JEA2ZKUA.js +1372 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LMGQAJ3O.js +9872 -0
  30. package/bundle/chunk-LVWU2HOO.js +1234 -0
  31. package/bundle/chunk-NIXWDZZV.js +9 -0
  32. package/bundle/chunk-QXASAHIA.js +173 -0
  33. package/bundle/chunk-RB4GELQA.js +458 -0
  34. package/bundle/chunk-RU522D5W.js +1768 -0
  35. package/bundle/chunk-SLNMBXLL.js +7336 -0
  36. package/bundle/chunk-SW2VMNIU.js +526 -0
  37. package/bundle/chunk-TGLFTQWJ.js +143 -0
  38. package/bundle/chunk-TMHVDPYW.js +4132 -0
  39. package/bundle/chunk-U4ODUYAG.js +235 -0
  40. package/bundle/chunk-UKG4V45O.js +228 -0
  41. package/bundle/chunk-UQDHXMUG.js +264 -0
  42. package/bundle/chunk-V2KFIGFH.js +8774 -0
  43. package/bundle/chunk-VO3G7HI3.js +85 -0
  44. package/bundle/chunk-WPW4V6HM.js +227 -0
  45. package/bundle/chunk-WW76JRIX.js +175 -0
  46. package/bundle/chunk-X6LOM3Z4.js +4175 -0
  47. package/bundle/chunk-XA3DY6UG.js +161 -0
  48. package/bundle/chunk-Y6H2G6KX.js +1310 -0
  49. package/bundle/chunk-YFCK7H2S.js +129 -0
  50. package/bundle/chunk-YYREO77V.js +137 -0
  51. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  52. package/bundle/chunk-ZWXU5SPQ.js +16932 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/goal-auto-continuation-gate.md +26 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -87
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1300 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/goal-auto-continue-gate.d.ts +17 -0
  196. package/src/goal-auto-continue-gate.js +61 -0
  197. package/src/goal-auto-continue-state.d.ts +22 -0
  198. package/src/goal-auto-continue-state.js +20 -0
  199. package/src/inspectors/actions.d.ts +24 -0
  200. package/src/inspectors/actions.js +182 -0
  201. package/src/inspectors/ghostty/actions.d.ts +11 -0
  202. package/src/inspectors/ghostty/actions.js +62 -0
  203. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  204. package/src/inspectors/ghostty/plugin.js +23 -0
  205. package/src/inspectors/herdr/actions.d.ts +25 -0
  206. package/src/inspectors/herdr/actions.js +133 -0
  207. package/src/inspectors/herdr/client.d.ts +41 -0
  208. package/src/inspectors/herdr/client.js +129 -0
  209. package/src/inspectors/herdr/focus.d.ts +24 -0
  210. package/src/inspectors/herdr/focus.js +49 -0
  211. package/src/inspectors/herdr/plugin.d.ts +6 -0
  212. package/src/inspectors/herdr/plugin.js +14 -0
  213. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  214. package/src/inspectors/herdr/project-panes.js +610 -0
  215. package/src/inspectors/inspector-runner.d.ts +23 -0
  216. package/src/inspectors/inspector-runner.js +161 -0
  217. package/src/inspectors/plugins.d.ts +8 -0
  218. package/src/inspectors/plugins.js +82 -0
  219. package/src/inspectors/session-roots-codec.d.ts +15 -0
  220. package/src/inspectors/session-roots-codec.js +32 -0
  221. package/src/inspectors/shell-command.d.ts +1 -0
  222. package/src/inspectors/shell-command.js +16 -0
  223. package/src/inspectors/tmux/actions.d.ts +25 -0
  224. package/src/inspectors/tmux/actions.js +181 -0
  225. package/src/inspectors/tmux/client.d.ts +27 -0
  226. package/src/inspectors/tmux/client.js +64 -0
  227. package/src/inspectors/tmux/plugin.d.ts +7 -0
  228. package/src/inspectors/tmux/plugin.js +14 -0
  229. package/src/inspectors/types.d.ts +48 -0
  230. package/src/inspectors/types.js +1 -0
  231. package/src/integrations/herdr-status.d.ts +47 -0
  232. package/src/integrations/herdr-status.js +350 -0
  233. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  234. package/src/integrations/pi-web-session-liveness.js +53 -0
  235. package/src/integrations/program-status.d.ts +30 -0
  236. package/src/integrations/program-status.js +188 -0
  237. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  238. package/src/intercom/fork-supervisor-routing.js +392 -0
  239. package/src/intercom/intercom-bridge.d.ts +58 -0
  240. package/src/intercom/intercom-bridge.js +193 -0
  241. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  242. package/src/intercom/native-supervisor-channel.js +1184 -0
  243. package/src/intercom/result-intercom.d.ts +35 -0
  244. package/src/intercom/result-intercom.js +376 -0
  245. package/src/intercom/supervisor-ui.d.ts +29 -0
  246. package/src/intercom/supervisor-ui.js +49 -0
  247. package/src/missions/actions.d.ts +54 -0
  248. package/src/missions/actions.js +400 -0
  249. package/src/missions/goal-driver.d.ts +16 -0
  250. package/src/missions/goal-driver.js +171 -0
  251. package/src/missions/lifecycle.d.ts +50 -0
  252. package/src/missions/lifecycle.js +388 -0
  253. package/src/missions/store.d.ts +21 -0
  254. package/src/missions/store.js +605 -0
  255. package/src/missions/types.d.ts +169 -0
  256. package/src/missions/types.js +9 -0
  257. package/src/missions/workflow-state.d.ts +14 -0
  258. package/src/missions/workflow-state.js +273 -0
  259. package/src/policy/authority.d.ts +9 -0
  260. package/src/policy/authority.js +41 -0
  261. package/src/profiles/profiles.d.ts +134 -0
  262. package/src/profiles/profiles.js +526 -0
  263. package/src/runs/background/active-async-capacity.d.ts +115 -0
  264. package/src/runs/background/active-async-capacity.js +517 -0
  265. package/src/runs/background/active-run-index.d.ts +12 -0
  266. package/src/runs/background/active-run-index.js +157 -0
  267. package/src/runs/background/async-execution.d.ts +306 -0
  268. package/src/runs/background/async-execution.js +2210 -0
  269. package/src/runs/background/async-job-tracker.d.ts +37 -0
  270. package/src/runs/background/async-job-tracker.js +926 -0
  271. package/src/runs/background/async-resume.d.ts +60 -0
  272. package/src/runs/background/async-resume.js +707 -0
  273. package/src/runs/background/async-retention.d.ts +45 -0
  274. package/src/runs/background/async-retention.js +932 -0
  275. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  276. package/src/runs/background/async-status-snapshot.js +26 -0
  277. package/src/runs/background/async-status.d.ts +179 -0
  278. package/src/runs/background/async-status.js +712 -0
  279. package/src/runs/background/auto-drain.d.ts +16 -0
  280. package/src/runs/background/auto-drain.js +71 -0
  281. package/src/runs/background/await-async-run.d.ts +26 -0
  282. package/src/runs/background/await-async-run.js +83 -0
  283. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  284. package/src/runs/background/binary-bootstrap.js +69 -0
  285. package/src/runs/background/boot-id.d.ts +12 -0
  286. package/src/runs/background/boot-id.js +47 -0
  287. package/src/runs/background/calendar-schedule.d.ts +26 -0
  288. package/src/runs/background/calendar-schedule.js +93 -0
  289. package/src/runs/background/chain-append.d.ts +34 -0
  290. package/src/runs/background/chain-append.js +299 -0
  291. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  292. package/src/runs/background/chain-root-attachment.js +186 -0
  293. package/src/runs/background/completion-batcher.d.ts +51 -0
  294. package/src/runs/background/completion-batcher.js +119 -0
  295. package/src/runs/background/completion-dedupe.d.ts +13 -0
  296. package/src/runs/background/completion-dedupe.js +48 -0
  297. package/src/runs/background/completion-replay.d.ts +47 -0
  298. package/src/runs/background/completion-replay.js +266 -0
  299. package/src/runs/background/control-channel.d.ts +170 -0
  300. package/src/runs/background/control-channel.js +610 -0
  301. package/src/runs/background/fleet-view.d.ts +63 -0
  302. package/src/runs/background/fleet-view.js +666 -0
  303. package/src/runs/background/index-segment.d.ts +16 -0
  304. package/src/runs/background/index-segment.js +58 -0
  305. package/src/runs/background/inspect-rpc.d.ts +64 -0
  306. package/src/runs/background/inspect-rpc.js +422 -0
  307. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  308. package/src/runs/background/interrupted-elsewhere.js +68 -0
  309. package/src/runs/background/notify.d.ts +216 -0
  310. package/src/runs/background/notify.js +1006 -0
  311. package/src/runs/background/owned-process-tree.d.ts +10 -0
  312. package/src/runs/background/owned-process-tree.js +116 -0
  313. package/src/runs/background/parallel-groups.d.ts +3 -0
  314. package/src/runs/background/parallel-groups.js +46 -0
  315. package/src/runs/background/pid-namespace.d.ts +2 -0
  316. package/src/runs/background/pid-namespace.js +19 -0
  317. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  318. package/src/runs/background/process-terminal-candidate.js +96 -0
  319. package/src/runs/background/process-terminal.d.ts +21 -0
  320. package/src/runs/background/process-terminal.js +227 -0
  321. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  322. package/src/runs/background/result-delivery-ownership.js +38 -0
  323. package/src/runs/background/result-files.d.ts +63 -0
  324. package/src/runs/background/result-files.js +629 -0
  325. package/src/runs/background/result-watcher.d.ts +92 -0
  326. package/src/runs/background/result-watcher.js +819 -0
  327. package/src/runs/background/resume-guidance.d.ts +4 -0
  328. package/src/runs/background/resume-guidance.js +57 -0
  329. package/src/runs/background/retained-children.d.ts +24 -0
  330. package/src/runs/background/retained-children.js +128 -0
  331. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  332. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  333. package/src/runs/background/run-child-session.d.ts +123 -0
  334. package/src/runs/background/run-child-session.js +670 -0
  335. package/src/runs/background/run-id-query.d.ts +3 -0
  336. package/src/runs/background/run-id-query.js +6 -0
  337. package/src/runs/background/run-id-resolver.d.ts +22 -0
  338. package/src/runs/background/run-id-resolver.js +172 -0
  339. package/src/runs/background/run-status.d.ts +25 -0
  340. package/src/runs/background/run-status.js +850 -0
  341. package/src/runs/background/runner-aliases.d.ts +17 -0
  342. package/src/runs/background/runner-aliases.js +191 -0
  343. package/src/runs/background/runner-child-launch.d.ts +24 -0
  344. package/src/runs/background/runner-child-launch.js +72 -0
  345. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  346. package/src/runs/background/runner-child-sessions.js +34 -0
  347. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  348. package/src/runs/background/runner-http-dispatcher.js +115 -0
  349. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  350. package/src/runs/background/runner-startup-failure.js +46 -0
  351. package/src/runs/background/scheduled-runs.d.ts +127 -0
  352. package/src/runs/background/scheduled-runs.js +1265 -0
  353. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  354. package/src/runs/background/stale-run-reconciler.js +509 -0
  355. package/src/runs/background/steering.d.ts +51 -0
  356. package/src/runs/background/steering.js +246 -0
  357. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  358. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  359. package/src/runs/background/subagent-runner.d.ts +210 -0
  360. package/src/runs/background/subagent-runner.js +4963 -0
  361. package/src/runs/background/subagent-wait.d.ts +124 -0
  362. package/src/runs/background/subagent-wait.js +756 -0
  363. package/src/runs/background/terminal-run-index.d.ts +10 -0
  364. package/src/runs/background/terminal-run-index.js +209 -0
  365. package/src/runs/background/top-level-async.d.ts +7 -0
  366. package/src/runs/background/top-level-async.js +5 -0
  367. package/src/runs/background/wait-completions.d.ts +28 -0
  368. package/src/runs/background/wait-completions.js +264 -0
  369. package/src/runs/background/wait-config.d.ts +8 -0
  370. package/src/runs/background/wait-config.js +46 -0
  371. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  372. package/src/runs/background/wait-subscriptions.js +339 -0
  373. package/src/runs/background/wait-tool.d.ts +6 -0
  374. package/src/runs/background/wait-tool.js +48 -0
  375. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  376. package/src/runs/background/workflow-terminal-proof.js +116 -0
  377. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  378. package/src/runs/foreground/async-dismiss-action.js +82 -0
  379. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  380. package/src/runs/foreground/async-steering-action.js +294 -0
  381. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  382. package/src/runs/foreground/async-stop-action.js +213 -0
  383. package/src/runs/foreground/command-action.d.ts +12 -0
  384. package/src/runs/foreground/command-action.js +38 -0
  385. package/src/runs/foreground/execution.d.ts +10 -0
  386. package/src/runs/foreground/execution.js +2322 -0
  387. package/src/runs/foreground/foreground-control.d.ts +24 -0
  388. package/src/runs/foreground/foreground-control.js +138 -0
  389. package/src/runs/foreground/foreground-history.d.ts +25 -0
  390. package/src/runs/foreground/foreground-history.js +267 -0
  391. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  392. package/src/runs/foreground/prompt-audit.js +138 -0
  393. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  394. package/src/runs/foreground/subagent-executor.js +7990 -0
  395. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  396. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  397. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  398. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  399. package/src/runs/shared/abort-recovery.d.ts +26 -0
  400. package/src/runs/shared/abort-recovery.js +108 -0
  401. package/src/runs/shared/acceptance.d.ts +144 -0
  402. package/src/runs/shared/acceptance.js +1616 -0
  403. package/src/runs/shared/agent-contract.d.ts +5 -0
  404. package/src/runs/shared/agent-contract.js +35 -0
  405. package/src/runs/shared/async-status-projection.d.ts +100 -0
  406. package/src/runs/shared/async-status-projection.js +566 -0
  407. package/src/runs/shared/background-process-options.d.ts +4 -0
  408. package/src/runs/shared/background-process-options.js +6 -0
  409. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  410. package/src/runs/shared/capability-ceiling.js +179 -0
  411. package/src/runs/shared/chain-outputs.d.ts +18 -0
  412. package/src/runs/shared/chain-outputs.js +104 -0
  413. package/src/runs/shared/child-commands.d.ts +29 -0
  414. package/src/runs/shared/child-commands.js +254 -0
  415. package/src/runs/shared/child-hooks.d.ts +31 -0
  416. package/src/runs/shared/child-hooks.js +173 -0
  417. package/src/runs/shared/child-identity.d.ts +23 -0
  418. package/src/runs/shared/child-identity.js +40 -0
  419. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  420. package/src/runs/shared/child-launch-plan.js +88 -0
  421. package/src/runs/shared/child-launch.d.ts +128 -0
  422. package/src/runs/shared/child-launch.js +262 -0
  423. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  424. package/src/runs/shared/child-lifecycle.js +22 -0
  425. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  426. package/src/runs/shared/child-runtime-config.js +44 -0
  427. package/src/runs/shared/child-session.d.ts +178 -0
  428. package/src/runs/shared/child-session.js +726 -0
  429. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  430. package/src/runs/shared/child-tool-plan.js +430 -0
  431. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  432. package/src/runs/shared/claude-code-adapter.js +255 -0
  433. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  434. package/src/runs/shared/codex-exec-adapter.js +127 -0
  435. package/src/runs/shared/context-mode.d.ts +12 -0
  436. package/src/runs/shared/context-mode.js +38 -0
  437. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  438. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  439. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  440. package/src/runs/shared/dynamic-fanout.js +273 -0
  441. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  442. package/src/runs/shared/effective-system-prompt.js +23 -0
  443. package/src/runs/shared/extension-bindings.d.ts +25 -0
  444. package/src/runs/shared/extension-bindings.js +96 -0
  445. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  446. package/src/runs/shared/external-cli-contract.js +145 -0
  447. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  448. package/src/runs/shared/external-cli-preflight.js +159 -0
  449. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  450. package/src/runs/shared/external-cli-runner.js +425 -0
  451. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  452. package/src/runs/shared/external-job-bridge.js +486 -0
  453. package/src/runs/shared/external-job-runner.d.ts +44 -0
  454. package/src/runs/shared/external-job-runner.js +352 -0
  455. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  456. package/src/runs/shared/fast-mode-extension.js +8 -0
  457. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  458. package/src/runs/shared/fork-placed-env.js +13 -0
  459. package/src/runs/shared/git-environment.d.ts +2 -0
  460. package/src/runs/shared/git-environment.js +27 -0
  461. package/src/runs/shared/herdr-connection.d.ts +79 -0
  462. package/src/runs/shared/herdr-connection.js +269 -0
  463. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  464. package/src/runs/shared/herdr-external-adapters.js +404 -0
  465. package/src/runs/shared/herdr-machine.d.ts +59 -0
  466. package/src/runs/shared/herdr-machine.js +294 -0
  467. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  468. package/src/runs/shared/herdr-pane-host.js +155 -0
  469. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  470. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  471. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  472. package/src/runs/shared/herdr-placed-run.js +380 -0
  473. package/src/runs/shared/host-step-status.d.ts +33 -0
  474. package/src/runs/shared/host-step-status.js +244 -0
  475. package/src/runs/shared/lane-metadata.d.ts +23 -0
  476. package/src/runs/shared/lane-metadata.js +126 -0
  477. package/src/runs/shared/launch-cwd.d.ts +1 -0
  478. package/src/runs/shared/launch-cwd.js +16 -0
  479. package/src/runs/shared/local-machine-access.d.ts +5 -0
  480. package/src/runs/shared/local-machine-access.js +28 -0
  481. package/src/runs/shared/long-running-guard.d.ts +34 -0
  482. package/src/runs/shared/long-running-guard.js +256 -0
  483. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  484. package/src/runs/shared/mcp-config-sources.js +418 -0
  485. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  486. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  487. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  488. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  489. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  490. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  491. package/src/runs/shared/model-resolution.d.ts +109 -0
  492. package/src/runs/shared/model-resolution.js +411 -0
  493. package/src/runs/shared/model-scope.d.ts +68 -0
  494. package/src/runs/shared/model-scope.js +171 -0
  495. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  496. package/src/runs/shared/mutation-evidence.js +198 -0
  497. package/src/runs/shared/nested-events.d.ts +135 -0
  498. package/src/runs/shared/nested-events.js +1090 -0
  499. package/src/runs/shared/nested-path.d.ts +8 -0
  500. package/src/runs/shared/nested-path.js +34 -0
  501. package/src/runs/shared/nested-render.d.ts +20 -0
  502. package/src/runs/shared/nested-render.js +115 -0
  503. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  504. package/src/runs/shared/orca-progress-tabs.js +503 -0
  505. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  506. package/src/runs/shared/parallel-handoff.js +783 -0
  507. package/src/runs/shared/parallel-utils.d.ts +177 -0
  508. package/src/runs/shared/parallel-utils.js +125 -0
  509. package/src/runs/shared/partial-output.d.ts +24 -0
  510. package/src/runs/shared/partial-output.js +35 -0
  511. package/src/runs/shared/permissions.d.ts +12 -0
  512. package/src/runs/shared/permissions.js +92 -0
  513. package/src/runs/shared/pi-spawn.d.ts +31 -0
  514. package/src/runs/shared/pi-spawn.js +211 -0
  515. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  516. package/src/runs/shared/placed-run-owner.js +93 -0
  517. package/src/runs/shared/placement-host.d.ts +99 -0
  518. package/src/runs/shared/placement-host.js +157 -0
  519. package/src/runs/shared/process-signal.d.ts +15 -0
  520. package/src/runs/shared/process-signal.js +21 -0
  521. package/src/runs/shared/profile-extensions.d.ts +21 -0
  522. package/src/runs/shared/profile-extensions.js +122 -0
  523. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  524. package/src/runs/shared/profile-launch-env.js +90 -0
  525. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  526. package/src/runs/shared/readonly-drain-observation.js +50 -0
  527. package/src/runs/shared/rex-machine.d.ts +25 -0
  528. package/src/runs/shared/rex-machine.js +83 -0
  529. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  530. package/src/runs/shared/rex-pane-host.js +327 -0
  531. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  532. package/src/runs/shared/run-fanout-budget.js +258 -0
  533. package/src/runs/shared/run-ownership.d.ts +3 -0
  534. package/src/runs/shared/run-ownership.js +8 -0
  535. package/src/runs/shared/runner-launcher.d.ts +11 -0
  536. package/src/runs/shared/runner-launcher.js +24 -0
  537. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  538. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  539. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  540. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  541. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  542. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  543. package/src/runs/shared/session-lease.d.ts +69 -0
  544. package/src/runs/shared/session-lease.js +250 -0
  545. package/src/runs/shared/single-output.d.ts +90 -0
  546. package/src/runs/shared/single-output.js +349 -0
  547. package/src/runs/shared/spawn-budget.d.ts +20 -0
  548. package/src/runs/shared/spawn-budget.js +93 -0
  549. package/src/runs/shared/structured-output.d.ts +66 -0
  550. package/src/runs/shared/structured-output.js +483 -0
  551. package/src/runs/shared/subagent-control.d.ts +50 -0
  552. package/src/runs/shared/subagent-control.js +247 -0
  553. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  554. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  555. package/src/runs/shared/tool-availability.d.ts +16 -0
  556. package/src/runs/shared/tool-availability.js +29 -0
  557. package/src/runs/shared/tool-budget.d.ts +21 -0
  558. package/src/runs/shared/tool-budget.js +78 -0
  559. package/src/runs/shared/tool-timeout.d.ts +31 -0
  560. package/src/runs/shared/tool-timeout.js +73 -0
  561. package/src/runs/shared/usage-budget.d.ts +7 -0
  562. package/src/runs/shared/usage-budget.js +74 -0
  563. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  564. package/src/runs/shared/usage-reconciliation.js +71 -0
  565. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  566. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  567. package/src/runs/shared/workflow-graph.d.ts +31 -0
  568. package/src/runs/shared/workflow-graph.js +221 -0
  569. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  570. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  571. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  572. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  573. package/src/runs/shared/worktree-lock.d.ts +5 -0
  574. package/src/runs/shared/worktree-lock.js +40 -0
  575. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  576. package/src/runs/shared/worktree-setup-command.js +200 -0
  577. package/src/runs/shared/worktree.d.ts +181 -0
  578. package/src/runs/shared/worktree.js +1346 -0
  579. package/src/shared/accessible-dir.d.ts +11 -0
  580. package/src/shared/accessible-dir.js +39 -0
  581. package/src/shared/agent-stream-options.d.ts +5 -0
  582. package/src/shared/agent-stream-options.js +3 -0
  583. package/src/shared/artifacts.d.ts +22 -0
  584. package/src/shared/artifacts.js +272 -0
  585. package/src/shared/atomic-json.d.ts +19 -0
  586. package/src/shared/atomic-json.js +61 -0
  587. package/src/shared/capacity-resilient-json.d.ts +26 -0
  588. package/src/shared/capacity-resilient-json.js +86 -0
  589. package/src/shared/child-cache-retention.d.ts +29 -0
  590. package/src/shared/child-cache-retention.js +40 -0
  591. package/src/shared/child-session-name.d.ts +8 -0
  592. package/src/shared/child-session-name.js +40 -0
  593. package/src/shared/child-transcript.d.ts +37 -0
  594. package/src/shared/child-transcript.js +225 -0
  595. package/src/shared/completion-owner.d.ts +7 -0
  596. package/src/shared/completion-owner.js +13 -0
  597. package/src/shared/disabled-features.d.ts +93 -0
  598. package/src/shared/disabled-features.js +120 -0
  599. package/src/shared/display-text.d.ts +5 -0
  600. package/src/shared/display-text.js +154 -0
  601. package/src/shared/edit-distance.d.ts +4 -0
  602. package/src/shared/edit-distance.js +32 -0
  603. package/src/shared/extension-context.d.ts +21 -0
  604. package/src/shared/extension-context.js +39 -0
  605. package/src/shared/file-coalescer.d.ts +11 -0
  606. package/src/shared/file-coalescer.js +34 -0
  607. package/src/shared/file-lease.d.ts +10 -0
  608. package/src/shared/file-lease.js +106 -0
  609. package/src/shared/file-system-retry.d.ts +31 -0
  610. package/src/shared/file-system-retry.js +84 -0
  611. package/src/shared/fork-context.d.ts +64 -0
  612. package/src/shared/fork-context.js +185 -0
  613. package/src/shared/fork-session-cwd.d.ts +2 -0
  614. package/src/shared/fork-session-cwd.js +23 -0
  615. package/src/shared/formatters.d.ts +35 -0
  616. package/src/shared/formatters.js +137 -0
  617. package/src/shared/jsonl-writer.d.ts +20 -0
  618. package/src/shared/jsonl-writer.js +67 -0
  619. package/src/shared/launch-contract.d.ts +65 -0
  620. package/src/shared/launch-contract.js +145 -0
  621. package/src/shared/model-info.d.ts +55 -0
  622. package/src/shared/model-info.js +103 -0
  623. package/src/shared/model-response-aliases.d.ts +1 -0
  624. package/src/shared/model-response-aliases.js +15 -0
  625. package/src/shared/node-executable.d.ts +1 -0
  626. package/src/shared/node-executable.js +20 -0
  627. package/src/shared/opencode-session-headers.d.ts +12 -0
  628. package/src/shared/opencode-session-headers.js +26 -0
  629. package/src/shared/package-version.d.ts +2 -0
  630. package/src/shared/package-version.js +14 -0
  631. package/src/shared/parent-wake.d.ts +26 -0
  632. package/src/shared/parent-wake.js +68 -0
  633. package/src/shared/permission-profile.d.ts +26 -0
  634. package/src/shared/permission-profile.js +49 -0
  635. package/src/shared/prompt-resources.d.ts +5 -0
  636. package/src/shared/prompt-resources.js +10 -0
  637. package/src/shared/provider-diagnostics.d.ts +9 -0
  638. package/src/shared/provider-diagnostics.js +75 -0
  639. package/src/shared/pruned-fork.d.ts +34 -0
  640. package/src/shared/pruned-fork.js +434 -0
  641. package/src/shared/required-child-extensions.d.ts +34 -0
  642. package/src/shared/required-child-extensions.js +105 -0
  643. package/src/shared/runtime-module-path.d.ts +10 -0
  644. package/src/shared/runtime-module-path.js +16 -0
  645. package/src/shared/sandbox-profile.d.ts +12 -0
  646. package/src/shared/sandbox-profile.js +35 -0
  647. package/src/shared/session-file-trust.d.ts +1 -0
  648. package/src/shared/session-file-trust.js +20 -0
  649. package/src/shared/session-identity.d.ts +8 -0
  650. package/src/shared/session-identity.js +32 -0
  651. package/src/shared/session-succession.d.ts +4 -0
  652. package/src/shared/session-succession.js +24 -0
  653. package/src/shared/session-tokens.d.ts +2 -0
  654. package/src/shared/session-tokens.js +58 -0
  655. package/src/shared/settings-file-lease.d.ts +4 -0
  656. package/src/shared/settings-file-lease.js +38 -0
  657. package/src/shared/settings.d.ts +146 -0
  658. package/src/shared/settings.js +247 -0
  659. package/src/shared/shortcuts.d.ts +1 -0
  660. package/src/shared/shortcuts.js +17 -0
  661. package/src/shared/status-format.d.ts +9 -0
  662. package/src/shared/status-format.js +60 -0
  663. package/src/shared/thinking-ceiling.d.ts +13 -0
  664. package/src/shared/thinking-ceiling.js +37 -0
  665. package/src/shared/types.d.ts +2842 -0
  666. package/src/shared/types.js +276 -0
  667. package/src/shared/utf8.d.ts +5 -0
  668. package/src/shared/utf8.js +12 -0
  669. package/src/shared/utils.d.ts +83 -0
  670. package/src/shared/utils.js +612 -0
  671. package/src/shared/watch-strategy.d.ts +2 -0
  672. package/src/shared/watch-strategy.js +5 -0
  673. package/src/shared/workflow-child-permit.d.ts +58 -0
  674. package/src/shared/workflow-child-permit.js +159 -0
  675. package/src/slash/delegation-adapters.d.ts +154 -0
  676. package/src/slash/delegation-adapters.js +316 -0
  677. package/src/slash/delegation-json.d.ts +10 -0
  678. package/src/slash/delegation-json.js +117 -0
  679. package/src/slash/delegation-request.d.ts +12 -0
  680. package/src/slash/delegation-request.js +174 -0
  681. package/src/slash/prompt-template-bridge.d.ts +29 -0
  682. package/src/slash/prompt-template-bridge.js +399 -0
  683. package/src/slash/prompt-workflows.d.ts +21 -0
  684. package/src/slash/prompt-workflows.js +274 -0
  685. package/src/slash/selector.d.ts +47 -0
  686. package/src/slash/selector.js +117 -0
  687. package/src/slash/slash-bridge.d.ts +30 -0
  688. package/src/slash/slash-bridge.js +132 -0
  689. package/src/slash/slash-commands.d.ts +10 -0
  690. package/src/slash/slash-commands.js +1059 -0
  691. package/src/slash/slash-live-state.d.ts +21 -0
  692. package/src/slash/slash-live-state.js +263 -0
  693. package/src/slash/subagent-cost.d.ts +29 -0
  694. package/src/slash/subagent-cost.js +310 -0
  695. package/src/slash/subagents-admin.d.ts +3 -0
  696. package/src/slash/subagents-admin.js +481 -0
  697. package/src/tui/fleet-layout.d.ts +20 -0
  698. package/src/tui/fleet-layout.js +17 -0
  699. package/src/tui/fleet-native-transcript.d.ts +53 -0
  700. package/src/tui/fleet-native-transcript.js +339 -0
  701. package/src/tui/fleet-status.d.ts +92 -0
  702. package/src/tui/fleet-status.js +1132 -0
  703. package/src/tui/fleet-transcript.d.ts +64 -0
  704. package/src/tui/fleet-transcript.js +544 -0
  705. package/src/tui/fleet-viewport.d.ts +12 -0
  706. package/src/tui/fleet-viewport.js +35 -0
  707. package/src/tui/fleet.d.ts +196 -0
  708. package/src/tui/fleet.js +1588 -0
  709. package/src/tui/mouse-events.d.ts +21 -0
  710. package/src/tui/mouse-events.js +26 -0
  711. package/src/tui/render-helpers.d.ts +23 -0
  712. package/src/tui/render-helpers.js +100 -0
  713. package/src/tui/render.d.ts +66 -0
  714. package/src/tui/render.js +3707 -0
  715. package/src/tui/running-tone.d.ts +10 -0
  716. package/src/tui/running-tone.js +22 -0
  717. package/src/tui/subagent-messages.d.ts +22 -0
  718. package/src/tui/subagent-messages.js +270 -0
  719. package/src/ui-silent-marker.d.ts +20 -0
  720. package/src/ui-silent-marker.js +25 -0
  721. package/src/watchdog/change-signature.d.ts +7 -0
  722. package/src/watchdog/change-signature.js +243 -0
  723. package/src/watchdog/child-status.d.ts +53 -0
  724. package/src/watchdog/child-status.js +187 -0
  725. package/src/watchdog/diff-tool.d.ts +25 -0
  726. package/src/watchdog/diff-tool.js +104 -0
  727. package/src/watchdog/emission-guard.d.ts +36 -0
  728. package/src/watchdog/emission-guard.js +97 -0
  729. package/src/watchdog/guidance.d.ts +3 -0
  730. package/src/watchdog/guidance.js +19 -0
  731. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  732. package/src/watchdog/lsp-diagnostics.js +489 -0
  733. package/src/watchdog/model-selection.d.ts +24 -0
  734. package/src/watchdog/model-selection.js +167 -0
  735. package/src/watchdog/permission-arbiter.d.ts +20 -0
  736. package/src/watchdog/permission-arbiter.js +135 -0
  737. package/src/watchdog/register-child.d.ts +13 -0
  738. package/src/watchdog/register-child.js +128 -0
  739. package/src/watchdog/register-main.d.ts +11 -0
  740. package/src/watchdog/register-main.js +400 -0
  741. package/src/watchdog/render.d.ts +3 -0
  742. package/src/watchdog/render.js +33 -0
  743. package/src/watchdog/review.d.ts +36 -0
  744. package/src/watchdog/review.js +319 -0
  745. package/src/watchdog/rules.d.ts +21 -0
  746. package/src/watchdog/rules.js +58 -0
  747. package/src/watchdog/runtime.d.ts +195 -0
  748. package/src/watchdog/runtime.js +864 -0
  749. package/src/watchdog/scope.d.ts +14 -0
  750. package/src/watchdog/scope.js +44 -0
  751. package/src/watchdog/settings.d.ts +29 -0
  752. package/src/watchdog/settings.js +480 -0
  753. package/src/watchdog/tool-actions.d.ts +17 -0
  754. package/src/watchdog/tool-actions.js +150 -0
  755. package/src/watchdog/turn-delta.d.ts +15 -0
  756. package/src/watchdog/turn-delta.js +188 -0
  757. package/src/watchdog/types.d.ts +141 -0
  758. package/src/watchdog/types.js +27 -0
  759. package/src/watchdog/warning-format.d.ts +7 -0
  760. package/src/watchdog/warning-format.js +59 -0
  761. package/src/workflows/chat-progress.d.ts +37 -0
  762. package/src/workflows/chat-progress.js +129 -0
  763. package/src/workflows/host-command.d.ts +30 -0
  764. package/src/workflows/host-command.js +227 -0
  765. package/src/workflows/scripted-workflow.d.ts +204 -0
  766. package/src/workflows/scripted-workflow.js +1673 -0
  767. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  768. package/src/workflows/structured-workflow-scripts.js +179 -0
  769. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  770. package/src/workflows/workflow-auto-resume.js +102 -0
  771. package/src/workflows/workflow-checklist.d.ts +127 -0
  772. package/src/workflows/workflow-checklist.js +314 -0
  773. package/src/workflows/workflow-child-summary.d.ts +24 -0
  774. package/src/workflows/workflow-child-summary.js +195 -0
  775. package/src/workflows/workflow-launch-record.d.ts +27 -0
  776. package/src/workflows/workflow-launch-record.js +48 -0
  777. package/src/workflows/workflow-preflight.d.ts +58 -0
  778. package/src/workflows/workflow-preflight.js +288 -0
  779. package/src/workflows/workflow-receipt.d.ts +34 -0
  780. package/src/workflows/workflow-receipt.js +454 -0
  781. package/src/workflows/workflow-resources.d.ts +55 -0
  782. package/src/workflows/workflow-resources.js +271 -0
  783. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  784. package/src/workflows/workflow-resume-claim.js +210 -0
  785. package/src/workflows/workflow-resume.d.ts +56 -0
  786. package/src/workflows/workflow-resume.js +106 -0
  787. package/src/workflows/workflow-reuse.d.ts +61 -0
  788. package/src/workflows/workflow-reuse.js +186 -0
  789. package/src/workflows/workflow-revival.d.ts +33 -0
  790. package/src/workflows/workflow-revival.js +111 -0
  791. package/src/workflows/workflow-settlement.d.ts +84 -0
  792. package/src/workflows/workflow-settlement.js +203 -0
  793. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  794. package/src/workflows/workflow-stop-cause.js +8 -0
  795. package/workflow-script-worker.cjs +1342 -0
  796. package/index.ts +0 -18
  797. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  798. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  799. package/skills/pi-subagents/references/execution-controls.md +0 -561
  800. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  801. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  802. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  803. package/src/agents/advertised-agent-prompt.ts +0 -82
  804. package/src/agents/agent-eject.ts +0 -339
  805. package/src/agents/agent-management.ts +0 -1442
  806. package/src/agents/agent-memory.ts +0 -341
  807. package/src/agents/agent-refinements.ts +0 -624
  808. package/src/agents/agent-scope.ts +0 -10
  809. package/src/agents/agent-selection.ts +0 -25
  810. package/src/agents/agent-serializer.ts +0 -195
  811. package/src/agents/agents.ts +0 -3169
  812. package/src/agents/builtin-names.ts +0 -16
  813. package/src/agents/chain-serializer.ts +0 -285
  814. package/src/agents/frontmatter.ts +0 -153
  815. package/src/agents/global-npm-root.ts +0 -58
  816. package/src/agents/identity.ts +0 -30
  817. package/src/agents/proactive-skills.ts +0 -197
  818. package/src/agents/runtime-agent-events.ts +0 -70
  819. package/src/agents/runtime-agent-registry.ts +0 -457
  820. package/src/agents/runtime-discovery.ts +0 -39
  821. package/src/agents/skills.ts +0 -787
  822. package/src/api/agent-management.ts +0 -9
  823. package/src/api/agents.ts +0 -19
  824. package/src/api/background-work.ts +0 -206
  825. package/src/api/capability-ceiling.ts +0 -16
  826. package/src/api/child-tool-plan.ts +0 -5
  827. package/src/api/control-channel.ts +0 -4
  828. package/src/api/delegation.ts +0 -131
  829. package/src/api/external-job-provider.ts +0 -195
  830. package/src/api/external-runs.ts +0 -282
  831. package/src/api/inspectors.ts +0 -27
  832. package/src/api/intercom-bridge.ts +0 -3
  833. package/src/api/preflight.ts +0 -641
  834. package/src/api/project-panes.ts +0 -32
  835. package/src/api/required-child-extensions.ts +0 -6
  836. package/src/api/shared-types.ts +0 -29
  837. package/src/api/supervisor-routing.ts +0 -196
  838. package/src/api/workflow-resources.ts +0 -6
  839. package/src/extension/config.ts +0 -262
  840. package/src/extension/context-injection.ts +0 -123
  841. package/src/extension/control-notices.ts +0 -53
  842. package/src/extension/declaration-pinning.ts +0 -164
  843. package/src/extension/doctor.ts +0 -284
  844. package/src/extension/fanout-child.ts +0 -282
  845. package/src/extension/herdr-pi-bridge.ts +0 -166
  846. package/src/extension/index.ts +0 -1212
  847. package/src/extension/public-execution.ts +0 -262
  848. package/src/extension/reply-workflow-script.ts +0 -67
  849. package/src/extension/rpc.ts +0 -881
  850. package/src/extension/schemas.ts +0 -337
  851. package/src/extension/steering-notices.ts +0 -35
  852. package/src/extension/subagent-guide.ts +0 -127
  853. package/src/extension/subagent-options.ts +0 -47
  854. package/src/extension/tool-activation.ts +0 -147
  855. package/src/extension/tool-description.ts +0 -193
  856. package/src/extension/tool-result.ts +0 -19
  857. package/src/extension/upgrade-notice.ts +0 -40
  858. package/src/inspectors/actions.ts +0 -174
  859. package/src/inspectors/ghostty/actions.ts +0 -74
  860. package/src/inspectors/ghostty/plugin.ts +0 -29
  861. package/src/inspectors/herdr/actions.ts +0 -155
  862. package/src/inspectors/herdr/client.ts +0 -130
  863. package/src/inspectors/herdr/focus.ts +0 -55
  864. package/src/inspectors/herdr/plugin.ts +0 -20
  865. package/src/inspectors/herdr/project-panes.ts +0 -733
  866. package/src/inspectors/inspector-runner.ts +0 -153
  867. package/src/inspectors/plugins.ts +0 -76
  868. package/src/inspectors/session-roots-codec.ts +0 -31
  869. package/src/inspectors/shell-command.ts +0 -16
  870. package/src/inspectors/tmux/actions.ts +0 -204
  871. package/src/inspectors/tmux/client.ts +0 -85
  872. package/src/inspectors/tmux/plugin.ts +0 -21
  873. package/src/inspectors/types.ts +0 -51
  874. package/src/integrations/herdr-status.ts +0 -385
  875. package/src/integrations/pi-web-session-liveness.ts +0 -73
  876. package/src/integrations/program-status.ts +0 -215
  877. package/src/intercom/fork-supervisor-routing.ts +0 -533
  878. package/src/intercom/intercom-bridge.ts +0 -235
  879. package/src/intercom/native-supervisor-channel.ts +0 -1066
  880. package/src/intercom/result-intercom.ts +0 -433
  881. package/src/intercom/supervisor-ui.ts +0 -72
  882. package/src/missions/actions.ts +0 -433
  883. package/src/missions/goal-driver.ts +0 -177
  884. package/src/missions/lifecycle.ts +0 -367
  885. package/src/missions/store.ts +0 -613
  886. package/src/missions/types.ts +0 -190
  887. package/src/missions/workflow-state.ts +0 -281
  888. package/src/policy/authority.ts +0 -50
  889. package/src/profiles/profiles.ts +0 -674
  890. package/src/runs/background/active-async-capacity.ts +0 -548
  891. package/src/runs/background/active-run-index.ts +0 -155
  892. package/src/runs/background/async-execution.ts +0 -2479
  893. package/src/runs/background/async-job-tracker.ts +0 -869
  894. package/src/runs/background/async-resume.ts +0 -686
  895. package/src/runs/background/async-retention.ts +0 -953
  896. package/src/runs/background/async-status-snapshot.ts +0 -46
  897. package/src/runs/background/async-status.ts +0 -787
  898. package/src/runs/background/auto-drain.ts +0 -92
  899. package/src/runs/background/await-async-run.ts +0 -83
  900. package/src/runs/background/binary-bootstrap.ts +0 -67
  901. package/src/runs/background/calendar-schedule.ts +0 -90
  902. package/src/runs/background/chain-append.ts +0 -321
  903. package/src/runs/background/chain-root-attachment.ts +0 -263
  904. package/src/runs/background/completion-batcher.ts +0 -168
  905. package/src/runs/background/completion-dedupe.ts +0 -58
  906. package/src/runs/background/completion-replay.ts +0 -287
  907. package/src/runs/background/control-channel.ts +0 -659
  908. package/src/runs/background/fleet-view.ts +0 -692
  909. package/src/runs/background/index-segment.ts +0 -59
  910. package/src/runs/background/inspect-rpc.ts +0 -443
  911. package/src/runs/background/notify.ts +0 -1083
  912. package/src/runs/background/owned-process-tree.ts +0 -131
  913. package/src/runs/background/parallel-groups.ts +0 -45
  914. package/src/runs/background/pid-namespace.ts +0 -18
  915. package/src/runs/background/process-terminal-candidate.ts +0 -98
  916. package/src/runs/background/process-terminal.ts +0 -231
  917. package/src/runs/background/result-delivery-ownership.ts +0 -45
  918. package/src/runs/background/result-files.ts +0 -634
  919. package/src/runs/background/result-watcher.ts +0 -842
  920. package/src/runs/background/resume-guidance.ts +0 -56
  921. package/src/runs/background/retained-children.ts +0 -136
  922. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  923. package/src/runs/background/run-child-session.ts +0 -725
  924. package/src/runs/background/run-id-query.ts +0 -7
  925. package/src/runs/background/run-id-resolver.ts +0 -183
  926. package/src/runs/background/run-status.ts +0 -803
  927. package/src/runs/background/runner-aliases.ts +0 -183
  928. package/src/runs/background/runner-child-launch.ts +0 -96
  929. package/src/runs/background/runner-child-sessions.ts +0 -32
  930. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  931. package/src/runs/background/runner-startup-failure.ts +0 -56
  932. package/src/runs/background/scheduled-runs.ts +0 -1222
  933. package/src/runs/background/stale-run-reconciler.ts +0 -463
  934. package/src/runs/background/steering.ts +0 -260
  935. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  936. package/src/runs/background/subagent-runner.ts +0 -5251
  937. package/src/runs/background/subagent-wait.ts +0 -895
  938. package/src/runs/background/terminal-run-index.ts +0 -183
  939. package/src/runs/background/top-level-async.ts +0 -14
  940. package/src/runs/background/wait-completions.ts +0 -262
  941. package/src/runs/background/wait-config.ts +0 -50
  942. package/src/runs/background/wait-subscriptions.ts +0 -354
  943. package/src/runs/background/wait-tool.ts +0 -57
  944. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  945. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  946. package/src/runs/foreground/async-steering-action.ts +0 -276
  947. package/src/runs/foreground/async-stop-action.ts +0 -216
  948. package/src/runs/foreground/command-action.ts +0 -41
  949. package/src/runs/foreground/execution.ts +0 -2315
  950. package/src/runs/foreground/foreground-control.ts +0 -157
  951. package/src/runs/foreground/foreground-history.ts +0 -164
  952. package/src/runs/foreground/prompt-audit.ts +0 -172
  953. package/src/runs/foreground/subagent-executor.ts +0 -8252
  954. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  955. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  956. package/src/runs/shared/abort-recovery.ts +0 -119
  957. package/src/runs/shared/acceptance.ts +0 -1664
  958. package/src/runs/shared/agent-contract.ts +0 -38
  959. package/src/runs/shared/async-status-projection.ts +0 -664
  960. package/src/runs/shared/background-process-options.ts +0 -9
  961. package/src/runs/shared/capability-ceiling.ts +0 -214
  962. package/src/runs/shared/chain-outputs.ts +0 -116
  963. package/src/runs/shared/child-commands.ts +0 -229
  964. package/src/runs/shared/child-hooks.ts +0 -175
  965. package/src/runs/shared/child-identity.ts +0 -62
  966. package/src/runs/shared/child-launch-plan.ts +0 -163
  967. package/src/runs/shared/child-launch.ts +0 -389
  968. package/src/runs/shared/child-lifecycle.ts +0 -28
  969. package/src/runs/shared/child-runtime-config.ts +0 -136
  970. package/src/runs/shared/child-session.ts +0 -699
  971. package/src/runs/shared/child-tool-plan.ts +0 -599
  972. package/src/runs/shared/claude-code-adapter.ts +0 -288
  973. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  974. package/src/runs/shared/context-mode.ts +0 -44
  975. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  976. package/src/runs/shared/dynamic-fanout.ts +0 -297
  977. package/src/runs/shared/effective-system-prompt.ts +0 -33
  978. package/src/runs/shared/extension-bindings.ts +0 -103
  979. package/src/runs/shared/external-cli-contract.ts +0 -177
  980. package/src/runs/shared/external-cli-preflight.ts +0 -190
  981. package/src/runs/shared/external-cli-runner.ts +0 -437
  982. package/src/runs/shared/external-job-bridge.ts +0 -514
  983. package/src/runs/shared/external-job-runner.ts +0 -389
  984. package/src/runs/shared/fast-mode-extension.ts +0 -10
  985. package/src/runs/shared/fork-command-result.ts +0 -10
  986. package/src/runs/shared/git-environment.ts +0 -29
  987. package/src/runs/shared/herdr-connection.ts +0 -134
  988. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  989. package/src/runs/shared/herdr-machine.ts +0 -279
  990. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  991. package/src/runs/shared/herdr-placed-run.ts +0 -264
  992. package/src/runs/shared/host-step-status.ts +0 -231
  993. package/src/runs/shared/lane-metadata.ts +0 -126
  994. package/src/runs/shared/launch-cwd.ts +0 -16
  995. package/src/runs/shared/long-running-guard.ts +0 -221
  996. package/src/runs/shared/mcp-config-sources.ts +0 -426
  997. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  998. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  999. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  1000. package/src/runs/shared/model-resolution.ts +0 -503
  1001. package/src/runs/shared/model-scope.ts +0 -224
  1002. package/src/runs/shared/mutation-evidence.ts +0 -199
  1003. package/src/runs/shared/nested-events.ts +0 -1125
  1004. package/src/runs/shared/nested-path.ts +0 -38
  1005. package/src/runs/shared/nested-render.ts +0 -127
  1006. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1007. package/src/runs/shared/parallel-handoff.ts +0 -789
  1008. package/src/runs/shared/parallel-utils.ts +0 -292
  1009. package/src/runs/shared/partial-output.ts +0 -48
  1010. package/src/runs/shared/permissions.ts +0 -86
  1011. package/src/runs/shared/pi-spawn.ts +0 -205
  1012. package/src/runs/shared/process-signal.ts +0 -35
  1013. package/src/runs/shared/profile-extensions.ts +0 -134
  1014. package/src/runs/shared/profile-launch-env.ts +0 -121
  1015. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1016. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1017. package/src/runs/shared/run-history.ts +0 -288
  1018. package/src/runs/shared/runner-launcher.ts +0 -25
  1019. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1020. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1021. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1022. package/src/runs/shared/session-lease.ts +0 -293
  1023. package/src/runs/shared/single-output.ts +0 -366
  1024. package/src/runs/shared/spawn-budget.ts +0 -128
  1025. package/src/runs/shared/structured-output.ts +0 -463
  1026. package/src/runs/shared/subagent-control.ts +0 -295
  1027. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1028. package/src/runs/shared/tool-availability.ts +0 -37
  1029. package/src/runs/shared/tool-budget.ts +0 -87
  1030. package/src/runs/shared/tool-timeout.ts +0 -93
  1031. package/src/runs/shared/usage-budget.ts +0 -65
  1032. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1033. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1034. package/src/runs/shared/workflow-graph.ts +0 -225
  1035. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1036. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1037. package/src/runs/shared/worktree-lock.ts +0 -29
  1038. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1039. package/src/runs/shared/worktree.ts +0 -1554
  1040. package/src/shared/accessible-dir.ts +0 -47
  1041. package/src/shared/agent-stream-options.ts +0 -5
  1042. package/src/shared/artifacts.ts +0 -281
  1043. package/src/shared/atomic-json.ts +0 -85
  1044. package/src/shared/capacity-resilient-json.ts +0 -102
  1045. package/src/shared/child-cache-retention.ts +0 -43
  1046. package/src/shared/child-session-name.ts +0 -48
  1047. package/src/shared/child-transcript.ts +0 -264
  1048. package/src/shared/completion-owner.ts +0 -14
  1049. package/src/shared/disabled-features.ts +0 -123
  1050. package/src/shared/display-text.ts +0 -150
  1051. package/src/shared/edit-distance.ts +0 -33
  1052. package/src/shared/extension-context.ts +0 -37
  1053. package/src/shared/file-coalescer.ts +0 -49
  1054. package/src/shared/file-lease.ts +0 -74
  1055. package/src/shared/file-system-retry.ts +0 -95
  1056. package/src/shared/fork-context.ts +0 -243
  1057. package/src/shared/fork-session-cwd.ts +0 -27
  1058. package/src/shared/formatters.ts +0 -142
  1059. package/src/shared/jsonl-writer.ts +0 -92
  1060. package/src/shared/launch-contract.ts +0 -206
  1061. package/src/shared/model-info.ts +0 -132
  1062. package/src/shared/model-response-aliases.ts +0 -13
  1063. package/src/shared/node-executable.ts +0 -21
  1064. package/src/shared/opencode-session-headers.ts +0 -30
  1065. package/src/shared/package-version.ts +0 -17
  1066. package/src/shared/parent-wake.ts +0 -79
  1067. package/src/shared/permission-profile.ts +0 -56
  1068. package/src/shared/prompt-resources.ts +0 -11
  1069. package/src/shared/pruned-fork.ts +0 -469
  1070. package/src/shared/required-child-extensions.ts +0 -115
  1071. package/src/shared/runtime-module-path.ts +0 -19
  1072. package/src/shared/sandbox-profile.ts +0 -37
  1073. package/src/shared/session-file-trust.ts +0 -19
  1074. package/src/shared/session-identity.ts +0 -10
  1075. package/src/shared/session-tokens.ts +0 -55
  1076. package/src/shared/settings-file-lease.ts +0 -36
  1077. package/src/shared/settings.ts +0 -412
  1078. package/src/shared/shortcuts.ts +0 -13
  1079. package/src/shared/status-format.ts +0 -55
  1080. package/src/shared/thinking-ceiling.ts +0 -46
  1081. package/src/shared/types.ts +0 -3105
  1082. package/src/shared/utf8.ts +0 -11
  1083. package/src/shared/utils.ts +0 -610
  1084. package/src/shared/watch-strategy.ts +0 -12
  1085. package/src/shared/workflow-child-permit.ts +0 -212
  1086. package/src/slash/delegation-adapters.ts +0 -452
  1087. package/src/slash/delegation-json.ts +0 -108
  1088. package/src/slash/delegation-request.ts +0 -176
  1089. package/src/slash/prompt-template-bridge.ts +0 -435
  1090. package/src/slash/prompt-workflows.ts +0 -298
  1091. package/src/slash/selector.ts +0 -147
  1092. package/src/slash/slash-bridge.ts +0 -192
  1093. package/src/slash/slash-commands.ts +0 -1096
  1094. package/src/slash/slash-live-state.ts +0 -310
  1095. package/src/slash/subagent-cost.ts +0 -317
  1096. package/src/slash/subagents-admin.ts +0 -489
  1097. package/src/tui/fleet-native-transcript.ts +0 -424
  1098. package/src/tui/fleet-status.ts +0 -1139
  1099. package/src/tui/fleet-transcript.ts +0 -591
  1100. package/src/tui/fleet.ts +0 -1618
  1101. package/src/tui/mouse-events.ts +0 -42
  1102. package/src/tui/render-helpers.ts +0 -111
  1103. package/src/tui/render.ts +0 -3824
  1104. package/src/tui/running-tone.ts +0 -28
  1105. package/src/tui/subagent-messages.ts +0 -305
  1106. package/src/ui-silent-marker.ts +0 -32
  1107. package/src/watchdog/change-signature.ts +0 -260
  1108. package/src/watchdog/child-status.ts +0 -225
  1109. package/src/watchdog/diff-tool.ts +0 -112
  1110. package/src/watchdog/emission-guard.ts +0 -125
  1111. package/src/watchdog/guidance.ts +0 -20
  1112. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1113. package/src/watchdog/model-selection.ts +0 -187
  1114. package/src/watchdog/permission-arbiter.ts +0 -154
  1115. package/src/watchdog/register-child.ts +0 -136
  1116. package/src/watchdog/register-main.ts +0 -425
  1117. package/src/watchdog/render.ts +0 -31
  1118. package/src/watchdog/review.ts +0 -362
  1119. package/src/watchdog/rules.ts +0 -70
  1120. package/src/watchdog/runtime.ts +0 -927
  1121. package/src/watchdog/scope.ts +0 -51
  1122. package/src/watchdog/settings.ts +0 -520
  1123. package/src/watchdog/tool-actions.ts +0 -156
  1124. package/src/watchdog/turn-delta.ts +0 -190
  1125. package/src/watchdog/types.ts +0 -186
  1126. package/src/watchdog/warning-format.ts +0 -72
  1127. package/src/workflows/chat-progress.ts +0 -152
  1128. package/src/workflows/host-command.ts +0 -235
  1129. package/src/workflows/scripted-workflow.ts +0 -2733
  1130. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1131. package/src/workflows/workflow-checklist.ts +0 -442
  1132. package/src/workflows/workflow-child-summary.ts +0 -172
  1133. package/src/workflows/workflow-preflight.ts +0 -297
  1134. package/src/workflows/workflow-receipt.ts +0 -390
  1135. package/src/workflows/workflow-resources.ts +0 -275
  1136. package/src/workflows/workflow-reuse.ts +0 -120
  1137. package/src/workflows/workflow-revival.ts +0 -123
  1138. package/src/workflows/workflow-settlement.ts +0 -252
@@ -1,1878 +0,0 @@
1
- import {
2
- AssistantMessageComponent,
3
- getMarkdownTheme,
4
- initTheme,
5
- ToolExecutionComponent,
6
- UserMessageComponent,
7
- } from "@earendil-works/pi-coding-agent";
8
- import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
9
- import {
10
- matchesKey,
11
- truncateToWidth,
12
- visibleWidth,
13
- wrapTextWithAnsi,
14
- } from "@earendil-works/pi-tui";
15
-
16
- /**
17
- * Structural subset of Pi's theme used by transcript rendering.
18
- * Pi theme-key unions vary across supported SDK versions, while the public
19
- * transcript API only passes named string keys.
20
- */
21
- export interface TranscriptTheme {
22
- fg(color: string, text: string): string;
23
- bg(color: string, text: string): string;
24
- bold(text: string): string;
25
- }
26
-
27
- /** Structural subset of Pi's TUI used by the scroll viewport. */
28
- export interface TranscriptTui {
29
- requestRender(): void;
30
- }
31
-
32
- /**
33
- * Structured tool result payload as delivered by agent session events. It is
34
- * stored verbatim so Pi's native tool renderers receive the same shape the
35
- * main transcript would.
36
- */
37
- export interface TranscriptToolResultPayload {
38
- content?: Array<{
39
- type?: string;
40
- text?: string;
41
- data?: string;
42
- mimeType?: string;
43
- }>;
44
- details?: unknown;
45
- }
46
-
47
- /**
48
- * Host context used to construct Pi's native `ToolExecutionComponent`
49
- * instances. Every field is optional: missing values fall back to a detached
50
- * stub TUI and `process.cwd()`.
51
- */
52
- export interface NativeToolRenderOptions {
53
- /** Structural TUI subset; only `requestRender` is required. */
54
- tui?: TranscriptTui;
55
- /** Working directory used to resolve built-in tool definitions. */
56
- cwd?: string;
57
- /** Resolver for extension-registered custom tool definitions. */
58
- resolveToolDefinition?: (toolName: string) => ToolDefinition | undefined;
59
- /** Pass-through for Pi's image rendering settings. */
60
- showImages?: boolean;
61
- imageWidthCells?: number;
62
- /** Initial expanded state for tool output. */
63
- expanded?: boolean;
64
- }
65
-
66
- /** Structural lookup accepted by render functions; maps satisfy this. */
67
- export interface ToolComponentLookup {
68
- get(toolCallId: string): ToolExecutionComponent | undefined;
69
- }
70
-
71
- /** Full TUI type expected by Pi's component constructor. */
72
- type NativeToolTui = NonNullable<
73
- ConstructorParameters<typeof ToolExecutionComponent>[5]
74
- >;
75
-
76
- type Theme = TranscriptTheme;
77
- type ThemeColor = string;
78
- type ThemeBackground = string;
79
-
80
- export type TranscriptNoticeTone = "info" | "warning" | "error";
81
-
82
- /**
83
- * How a turn ended. A host that distinguishes a completed exchange from one the
84
- * user aborted or that failed records it on the turn's end boundary; rendering
85
- * treats every finished turn the same, so this stays metadata for hosts/tests.
86
- */
87
- export type TranscriptTurnOutcome = "completed" | "aborted" | "failed";
88
-
89
- export type TranscriptEntry =
90
- | {
91
- id: number;
92
- turnId: number;
93
- type: "turn-boundary";
94
- phase: "start" | "end";
95
- /** Present on `end` boundaries when the host reported how the turn ended. */
96
- outcome?: TranscriptTurnOutcome;
97
- }
98
- | { id: number; turnId: number; type: "user-message"; text: string }
99
- | {
100
- id: number;
101
- turnId: number;
102
- type: "thinking";
103
- text: string;
104
- streaming: boolean;
105
- }
106
- | {
107
- id: number;
108
- turnId: number;
109
- type: "assistant-text";
110
- text: string;
111
- streaming: boolean;
112
- }
113
- | {
114
- id: number;
115
- turnId: number;
116
- type: "tool-call";
117
- toolCallId: string;
118
- toolName: string;
119
- /** Raw provider arguments object, preserved for native renderers. */
120
- args: unknown;
121
- }
122
- | {
123
- id: number;
124
- turnId: number;
125
- type: "tool-result";
126
- toolCallId: string;
127
- toolName: string;
128
- /** Raw structured result; `null` until the first result arrives. */
129
- result: TranscriptToolResultPayload | null;
130
- isError: boolean;
131
- streaming: boolean;
132
- }
133
- | {
134
- id: number;
135
- turnId: number;
136
- type: "notice";
137
- text: string;
138
- tone: TranscriptNoticeTone;
139
- };
140
-
141
- interface ActiveAssistantSegment {
142
- turnId: number;
143
- thinkingEntryId?: number;
144
- textEntryId?: number;
145
- }
146
-
147
- export interface TranscriptState {
148
- entries: TranscriptEntry[];
149
- nextEntryId: number;
150
- nextTurnId: number;
151
- currentTurnId: number | null;
152
- lastTurnId: number | null;
153
- activeAssistant: ActiveAssistantSegment | null;
154
- toolCalls: Map<
155
- string,
156
- { turnId: number; callEntryId: number; resultEntryId?: number }
157
- >;
158
- /** Persistent native tool components keyed by tool call id. */
159
- toolComponents: TranscriptToolComponents;
160
- /** Argument char cap applied to every recorded tool call. */
161
- toolArgsCharLimit: number;
162
- }
163
-
164
- export interface SessionTranscriptOptions extends NativeToolRenderOptions {
165
- /** Maximum retained entries. Oldest entries are discarded first. */
166
- maxEntries?: number;
167
- /** Maximum retained text across all entries. */
168
- maxChars?: number;
169
- /**
170
- * Per-tool-call argument size cap in JSON characters. Oversized arguments
171
- * are replaced by a truncated marker object so pathological payloads cannot
172
- * break rendering or memory bounds. Defaults to 64 KiB.
173
- */
174
- maxToolArgsChars?: number;
175
- }
176
-
177
- const DEFAULT_MAX_ENTRIES = 500;
178
- const DEFAULT_MAX_CHARS = 512 * 1024;
179
- const DEFAULT_MAX_TOOL_ARGS_CHARS = 64 * 1024;
180
-
181
- let themeEnsured = false;
182
-
183
- /**
184
- * The SDK shares its global theme across module instances (tsx/jiti/host) via
185
- * these globalThis symbols — the same keys its exported `theme` proxy checks
186
- * before throwing "Theme not initialized" (see theme.js in pi-coding-agent).
187
- * Both historical and current spellings are probed for older host support.
188
- */
189
- const THEME_GLOBAL_KEY = Symbol.for("@earendil-works/pi-coding-agent:theme");
190
- const THEME_GLOBAL_KEY_OLD = Symbol.for("@mariozechner/pi-coding-agent:theme");
191
-
192
- function isTranscriptThemeInitialized(): boolean {
193
- // SAFETY: the SDK stores its theme on globalThis under a symbol key; the
194
- // proxy does `if (!t) throw` on the same lookup, so a defined value means
195
- // a fully constructed Theme instance the proxy will hand back directly.
196
- const globals = globalThis as unknown as Record<PropertyKey, unknown>;
197
- return (
198
- globals[THEME_GLOBAL_KEY] !== undefined ||
199
- globals[THEME_GLOBAL_KEY_OLD] !== undefined
200
- );
201
- }
202
-
203
- /**
204
- * Ensures Pi's global theme is initialized so native message/tool components
205
- * can render outside a live interactive session (headless embeds, unit tests).
206
- *
207
- * IMPORTANT: when the host has already initialized the theme (interactive Pi
208
- * installs the user's chosen theme before any transcript renders), this is a
209
- * strict no-op. Re-calling `initTheme()` would re-resolve the default theme
210
- * from environment detection and can silently replace the user's selection
211
- * with the dark fallback — changing tool-call colors in the main session too.
212
- */
213
- export function ensureTranscriptTheme(): void {
214
- if (themeEnsured) return;
215
- themeEnsured = true;
216
- if (isTranscriptThemeInitialized()) return;
217
- initTheme();
218
- }
219
-
220
- const DETACHED_TUI: TranscriptTui = { requestRender() {} };
221
-
222
- /**
223
- * Owns the persistent `ToolExecutionComponent` instance for every live tool
224
- * call, mirroring how Pi's interactive mode keeps pending components keyed by
225
- * `toolCallId`. Instances are updated incrementally as events arrive and are
226
- * pruned by the host once their transcript entries disappear.
227
- */
228
- export class TranscriptToolComponents implements ToolComponentLookup {
229
- private readonly components = new Map<string, ToolExecutionComponent>();
230
- private readonly options: NativeToolRenderOptions;
231
- private attachedTui: TranscriptTui | null;
232
- /**
233
- * Components capture their TUI at construction. This forwarder lets a host
234
- * attach (or replace) the real TUI at any time — including after tool
235
- * events already created instances — without rebuilding them.
236
- */
237
- private readonly forwardedTui: TranscriptTui;
238
-
239
- constructor(options: NativeToolRenderOptions = {}) {
240
- this.options = options;
241
- this.attachedTui = options.tui ?? null;
242
- this.forwardedTui = {
243
- requestRender: () => this.attachedTui?.requestRender(),
244
- };
245
- }
246
-
247
- /** Wires (or replaces) the host TUI that receives repaint requests. */
248
- attachTui(tui: TranscriptTui): void {
249
- this.attachedTui = tui;
250
- }
251
-
252
- get size(): number {
253
- return this.components.size;
254
- }
255
-
256
- has(toolCallId: string): boolean {
257
- return this.components.has(toolCallId);
258
- }
259
-
260
- get(toolCallId: string): ToolExecutionComponent | undefined {
261
- return this.components.get(toolCallId);
262
- }
263
-
264
- handleStart(toolCallId: string, toolName: string, args: unknown): void {
265
- const component = this.ensure(toolCallId, toolName);
266
- if (this.createdWithoutArgs.delete(toolCallId)) {
267
- component.updateArgs(args ?? {});
268
- }
269
- component.setArgsComplete();
270
- component.markExecutionStarted();
271
- this.requestRender();
272
- }
273
-
274
- handleUpdate(
275
- toolCallId: string,
276
- toolName: string,
277
- partialResult: unknown,
278
- ): void {
279
- const component = this.ensure(toolCallId, toolName);
280
- component.updateResult(toComponentResult(partialResult, false), true);
281
- this.requestRender();
282
- }
283
-
284
- handleEnd(
285
- toolCallId: string,
286
- toolName: string,
287
- result: unknown,
288
- isError: boolean,
289
- ): void {
290
- const component = this.ensure(toolCallId, toolName);
291
- component.updateResult(toComponentResult(result, isError), false);
292
- this.requestRender();
293
- }
294
-
295
- /** Drops instances whose transcript entries no longer exist. */
296
- retainOnly(aliveToolCallIds: ReadonlySet<string>): void {
297
- for (const toolCallId of this.components.keys()) {
298
- if (!aliveToolCallIds.has(toolCallId)) this.components.delete(toolCallId);
299
- }
300
- }
301
-
302
- clear(): void {
303
- this.components.clear();
304
- }
305
-
306
- private ensure(toolCallId: string, toolName: string): ToolExecutionComponent {
307
- const existing = this.components.get(toolCallId);
308
- if (existing) return existing;
309
- // Results may arrive before their start event; remember the placeholder so
310
- // handleStart can backfill the real arguments later.
311
- this.createdWithoutArgs.add(toolCallId);
312
- const component = new ToolExecutionComponent(
313
- toolName,
314
- toolCallId,
315
- {},
316
- {
317
- showImages: this.options.showImages,
318
- imageWidthCells: this.options.imageWidthCells,
319
- },
320
- this.options.resolveToolDefinition?.(toolName),
321
- // Forwards to the attached host TUI; only requestRender is invoked.
322
- this.forwardedTui as NativeToolTui,
323
- this.options.cwd ?? process.cwd(),
324
- );
325
- if (this.options.expanded) component.setExpanded(true);
326
- this.components.set(toolCallId, component);
327
- return component;
328
- }
329
-
330
- private requestRender(): void {
331
- // Matches Pi's interactive mode, which repaints after every tool event.
332
- this.attachedTui?.requestRender();
333
- }
334
-
335
- private readonly createdWithoutArgs = new Set<string>();
336
- }
337
-
338
- function toComponentResult(
339
- value: unknown,
340
- isError: boolean,
341
- ): {
342
- content: Array<{
343
- type: string;
344
- text?: string;
345
- data?: string;
346
- mimeType?: string;
347
- }>;
348
- details?: unknown;
349
- isError: boolean;
350
- } {
351
- const payload =
352
- value && typeof value === "object"
353
- ? (value as TranscriptToolResultPayload)
354
- : {};
355
- const content = Array.isArray(payload.content)
356
- ? payload.content.map((part) => ({
357
- type: part?.type ?? "text",
358
- text: part?.text,
359
- data: part?.data,
360
- mimeType: part?.mimeType,
361
- }))
362
- : [];
363
- return { content, details: payload.details, isError };
364
- }
365
-
366
- export function createTranscriptState(
367
- nativeTools: NativeToolRenderOptions & SessionTranscriptOptions = {},
368
- ): TranscriptState {
369
- return {
370
- entries: [],
371
- nextEntryId: 1,
372
- nextTurnId: 1,
373
- currentTurnId: null,
374
- lastTurnId: null,
375
- activeAssistant: null,
376
- toolCalls: new Map(),
377
- toolComponents: new TranscriptToolComponents(nativeTools),
378
- toolArgsCharLimit: Math.max(
379
- 16,
380
- nativeTools.maxToolArgsChars ?? DEFAULT_MAX_TOOL_ARGS_CHARS,
381
- ),
382
- };
383
- }
384
-
385
- function codePointWidth(codePoint: number): 1 | 2 {
386
- return codePoint > 0xffff ? 2 : 1;
387
- }
388
-
389
- function isUnsafeTerminalCodePoint(codePoint: number): boolean {
390
- return (
391
- (codePoint <= 0x1f && codePoint !== 0x09 && codePoint !== 0x0a) ||
392
- (codePoint >= 0x7f && codePoint <= 0x9f) ||
393
- codePoint === 0x061c ||
394
- codePoint === 0x200e ||
395
- codePoint === 0x200f ||
396
- (codePoint >= 0x202a && codePoint <= 0x202e) ||
397
- (codePoint >= 0x2066 && codePoint <= 0x2069) ||
398
- (codePoint >= 0xe000 && codePoint <= 0xf8ff) ||
399
- (codePoint >= 0xf0000 && codePoint <= 0xffffd) ||
400
- (codePoint >= 0x100000 && codePoint <= 0x10fffd) ||
401
- (codePoint >= 0xd800 && codePoint <= 0xdfff) ||
402
- (codePoint >= 0xfdd0 && codePoint <= 0xfdef) ||
403
- (codePoint & 0xffff) === 0xfffe ||
404
- (codePoint & 0xffff) === 0xffff
405
- );
406
- }
407
-
408
- function consumeControlString(
409
- value: string,
410
- start: number,
411
- osc: boolean,
412
- ): number {
413
- let index = start;
414
- while (index < value.length) {
415
- const codePoint = value.codePointAt(index);
416
- if (codePoint === undefined) break;
417
- const width = codePointWidth(codePoint);
418
- if (osc && codePoint === 0x07) return index + width;
419
- if (codePoint === 0x9c) return index + width;
420
- if (codePoint === 0x1b && value.charCodeAt(index + 1) === 0x5c)
421
- return index + 2;
422
- index += width;
423
- }
424
- return value.length;
425
- }
426
-
427
- function consumeCsi(value: string, start: number): number {
428
- let index = start;
429
- while (index < value.length) {
430
- const codePoint = value.codePointAt(index);
431
- if (codePoint === undefined) break;
432
- const width = codePointWidth(codePoint);
433
- if (codePoint >= 0x40 && codePoint <= 0x7e) return index + width;
434
- index += width;
435
- }
436
- return value.length;
437
- }
438
-
439
- function looksLikeBinaryContent(text: string): boolean {
440
- if (text.includes("\0")) return true;
441
- let suspiciousControls = 0;
442
- let replacementCharacters = 0;
443
- let codePoints = 0;
444
- for (const character of text) {
445
- codePoints++;
446
- const codePoint = character.codePointAt(0) ?? 0;
447
- if (codePoint <= 0x08 || (codePoint >= 0x0e && codePoint <= 0x1f))
448
- suspiciousControls++;
449
- if (codePoint === 0xfffd) replacementCharacters++;
450
- }
451
- return (
452
- codePoints > 0 &&
453
- ((suspiciousControls >= 4 && suspiciousControls / codePoints >= 0.1) ||
454
- (replacementCharacters >= 3 && replacementCharacters / codePoints >= 0.1))
455
- );
456
- }
457
-
458
- /** Escapes terminal control sequences in model and tool output before rendering. */
459
- export function safeTerminalText(value: string): string {
460
- const normalized = value.replace(/\r\n/g, "\n");
461
- if (looksLikeBinaryContent(normalized))
462
- return "[binary content omitted for safe display]";
463
-
464
- let safe = "";
465
- for (let index = 0; index < normalized.length; ) {
466
- const codePoint = normalized.codePointAt(index);
467
- if (codePoint === undefined) break;
468
- const width = codePointWidth(codePoint);
469
- if (codePoint === 0x1b) {
470
- const next = normalized.charCodeAt(index + 1);
471
- if (next === 0x5b) {
472
- index = consumeCsi(normalized, index + 2);
473
- continue;
474
- }
475
- if (
476
- next === 0x5d ||
477
- next === 0x50 ||
478
- next === 0x58 ||
479
- next === 0x5e ||
480
- next === 0x5f
481
- ) {
482
- index = consumeControlString(normalized, index + 2, next === 0x5d);
483
- continue;
484
- }
485
- index += next ? 2 : 1;
486
- continue;
487
- }
488
- if (codePoint === 0x9b) {
489
- index = consumeCsi(normalized, index + width);
490
- continue;
491
- }
492
- if (
493
- codePoint === 0x90 ||
494
- codePoint === 0x98 ||
495
- codePoint === 0x9d ||
496
- codePoint === 0x9e ||
497
- codePoint === 0x9f
498
- ) {
499
- index = consumeControlString(
500
- normalized,
501
- index + width,
502
- codePoint === 0x9d,
503
- );
504
- continue;
505
- }
506
- safe += isUnsafeTerminalCodePoint(codePoint)
507
- ? `[U+${codePoint.toString(16).toUpperCase().padStart(4, "0")}]`
508
- : String.fromCodePoint(codePoint);
509
- index += width;
510
- }
511
- return safe;
512
- }
513
-
514
- /**
515
- * Appends a fully-formed entry, assigning the next sequential id.
516
- *
517
- * Public building block for hosts that construct transcripts from historical
518
- * records instead of live agent events. The entry must be structurally valid
519
- * for its `type`; ids and array placement are owned by this function.
520
- */
521
- export function appendEntry(
522
- state: TranscriptState,
523
- entry: Omit<TranscriptEntry, "id"> & Record<string, unknown>,
524
- ): TranscriptEntry {
525
- const nextEntry = { ...entry, id: state.nextEntryId++ } as TranscriptEntry;
526
- state.entries.push(nextEntry);
527
- return nextEntry;
528
- }
529
-
530
- /**
531
- * Returns the active turn id, opening a new turn (with a start boundary)
532
- * when none is open. Public building block for historical-record ingestion.
533
- */
534
- export function ensureTurn(state: TranscriptState): number {
535
- if (state.currentTurnId !== null) return state.currentTurnId;
536
- const turnId = state.nextTurnId++;
537
- state.currentTurnId = turnId;
538
- state.lastTurnId = turnId;
539
- appendEntry(state, { type: "turn-boundary", turnId, phase: "start" });
540
- return turnId;
541
- }
542
-
543
- /**
544
- * Finds the most recent entry of `type` inside `turnId`, scanning backwards.
545
- * Public building block used by upsert-style helpers and hosts that merge
546
- * repeated records (e.g. streamed message updates persisted as several lines).
547
- */
548
- export function findLatestEntry<TType extends TranscriptEntry["type"]>(
549
- state: TranscriptState,
550
- turnId: number,
551
- type: TType,
552
- ): Extract<TranscriptEntry, { type: TType }> | undefined {
553
- for (let index = state.entries.length - 1; index >= 0; index--) {
554
- const entry = state.entries[index];
555
- if (!entry) continue;
556
- if (entry.turnId === turnId && entry.type === type) {
557
- return entry as Extract<TranscriptEntry, { type: TType }>;
558
- }
559
- }
560
- return undefined;
561
- }
562
-
563
- /**
564
- * Closes `turnId` (defaulting to the current turn): appends the end boundary
565
- * unless one already exists, clears streaming flags on the turn's entries,
566
- * and updates bookkeeping. Idempotent — finishing an already-finished turn is
567
- * a no-op for boundary creation. An optional `outcome` is recorded on the end
568
- * boundary, letting hosts distinguish completed, aborted, and failed turns.
569
- * Public building block for hosts that know when a replayed exchange is
570
- * complete.
571
- */
572
- export function finishTurn(
573
- state: TranscriptState,
574
- turnId: number | null = state.currentTurnId,
575
- outcome?: TranscriptTurnOutcome,
576
- ): void {
577
- if (turnId === null) return;
578
- const endBoundary = state.entries.find(
579
- (entry): entry is Extract<TranscriptEntry, { type: "turn-boundary" }> =>
580
- entry.turnId === turnId &&
581
- entry.type === "turn-boundary" &&
582
- entry.phase === "end",
583
- );
584
- if (endBoundary) {
585
- if (outcome !== undefined) endBoundary.outcome = outcome;
586
- } else {
587
- appendEntry(state, {
588
- type: "turn-boundary",
589
- turnId,
590
- phase: "end",
591
- ...(outcome === undefined ? {} : { outcome }),
592
- });
593
- }
594
- for (const entry of state.entries) {
595
- if (entry.turnId !== turnId) continue;
596
- if (
597
- entry.type === "thinking" ||
598
- entry.type === "assistant-text" ||
599
- entry.type === "tool-result"
600
- ) {
601
- entry.streaming = false;
602
- }
603
- }
604
- state.lastTurnId = turnId;
605
- if (state.currentTurnId === turnId) state.currentTurnId = null;
606
- if (state.activeAssistant?.turnId === turnId) state.activeAssistant = null;
607
- }
608
-
609
- export function removeTranscriptTurn(
610
- state: TranscriptState,
611
- turnId: number | null,
612
- ): void {
613
- if (turnId === null) return;
614
- state.entries = state.entries.filter((entry) => entry.turnId !== turnId);
615
- for (const [toolCallId, toolCall] of state.toolCalls.entries()) {
616
- if (toolCall.turnId === turnId) state.toolCalls.delete(toolCallId);
617
- }
618
- if (state.currentTurnId === turnId) state.currentTurnId = null;
619
- if (state.lastTurnId === turnId) state.lastTurnId = null;
620
- if (state.activeAssistant?.turnId === turnId) state.activeAssistant = null;
621
- state.toolComponents.retainOnly(new Set(state.toolCalls.keys()));
622
- }
623
-
624
- function extractMessageText(message: { content?: unknown }): string {
625
- if (typeof message.content === "string")
626
- return safeTerminalText(message.content);
627
- if (!Array.isArray(message.content)) return "";
628
-
629
- const textParts: string[] = [];
630
- for (const part of message.content) {
631
- if (!part || typeof part !== "object") continue;
632
- const typedPart = part as { type?: unknown; text?: unknown };
633
- if (typedPart.type === "text" && typeof typedPart.text === "string") {
634
- textParts.push(safeTerminalText(typedPart.text));
635
- }
636
- }
637
- return textParts.join("\n").trim();
638
- }
639
-
640
- function extractThinking(message: { content?: unknown }): string {
641
- if (!Array.isArray(message.content)) return "";
642
-
643
- const thinkingParts: string[] = [];
644
- for (const part of message.content) {
645
- if (!part || typeof part !== "object") continue;
646
- const typedPart = part as { type?: unknown; thinking?: unknown };
647
- if (
648
- typedPart.type === "thinking" &&
649
- typeof typedPart.thinking === "string"
650
- ) {
651
- thinkingParts.push(safeTerminalText(typedPart.thinking));
652
- }
653
- }
654
- return thinkingParts.join("\n").trim();
655
- }
656
-
657
- function jsonSize(value: unknown): number {
658
- if (value === undefined || value === null) return 0;
659
- try {
660
- return JSON.stringify(value)?.length ?? 0;
661
- } catch {
662
- return String(value).length;
663
- }
664
- }
665
-
666
- function estimateToolResultSize(
667
- result: TranscriptToolResultPayload | null,
668
- ): number {
669
- if (!result) return 0;
670
- let size = 0;
671
- if (Array.isArray(result.content)) {
672
- for (const part of result.content) {
673
- if (!part || typeof part !== "object") continue;
674
- if (typeof part.text === "string") size += part.text.length;
675
- if (typeof part.data === "string") size += part.data.length;
676
- }
677
- }
678
- return size + jsonSize(result.details);
679
- }
680
-
681
- /** Deep-copies structured tool data for snapshots; falls back to the reference. */
682
- function cloneStructured<T>(value: T): T {
683
- if (value === null || typeof value !== "object") return value;
684
- try {
685
- return structuredClone(value);
686
- } catch {
687
- return value;
688
- }
689
- }
690
-
691
- /**
692
- * Degraded stand-in stored on a tool-call entry when the original arguments
693
- * exceed the state's char limit or cannot be serialized. Consumers can narrow
694
- * with the `truncated` flag; rendering falls back to the preview text.
695
- */
696
- export interface TruncatedToolArgs {
697
- truncated: true;
698
- /** Present only when JSON serialization of the original payload failed. */
699
- reason?: "unserializable";
700
- /** Serialized length of the original payload, when it was serializable. */
701
- originalChars?: number;
702
- preview: string;
703
- }
704
-
705
- function buildTruncatedToolArgs(
706
- serialized: string | undefined,
707
- raw: unknown,
708
- limit: number,
709
- ): TruncatedToolArgs {
710
- if (serialized === undefined) {
711
- return {
712
- truncated: true,
713
- reason: "unserializable",
714
- preview: String(raw).slice(0, limit),
715
- };
716
- }
717
- return {
718
- truncated: true,
719
- originalChars: serialized.length,
720
- preview: serialized.slice(0, limit),
721
- };
722
- }
723
-
724
- /**
725
- * Returns a truncation marker when pathological tool arguments exceed
726
- * `limit` (or cannot be serialized), and `null` when the payload may be
727
- * stored verbatim. Ingestion therefore never throws and rendering stays
728
- * bounded regardless of provider payload size.
729
- */
730
- function oversizedToolArgs(
731
- args: unknown,
732
- limit: number,
733
- ): TruncatedToolArgs | null {
734
- if (args === undefined || args === null) return null;
735
- let serialized: string | undefined;
736
- try {
737
- serialized = JSON.stringify(args);
738
- } catch {
739
- serialized = undefined;
740
- }
741
- if (serialized === undefined) {
742
- return buildTruncatedToolArgs(undefined, args, limit);
743
- }
744
- return serialized.length <= limit
745
- ? null
746
- : buildTruncatedToolArgs(serialized, args, limit);
747
- }
748
-
749
- /**
750
- * Finds or creates the tool-call record for `toolCallId`, appending a
751
- * tool-call entry when none exists yet.
752
- *
753
- * Public building block for hosts that ingest historical records where calls
754
- * and results may arrive in either order: when the result was recorded first,
755
- * the placeholder entry's arguments are backfilled here from the later call
756
- * record. Arguments exceeding the state's char limit are stored as a
757
- * truncated marker object instead of failing.
758
- */
759
- export function ensureToolCall(
760
- state: TranscriptState,
761
- turnId: number,
762
- toolCallId: string,
763
- toolName: string,
764
- args: unknown,
765
- ): { turnId: number; callEntryId: number; resultEntryId?: number } {
766
- const existing = state.toolCalls.get(toolCallId);
767
- if (existing) {
768
- // Result-before-call replay: backfill arguments onto the placeholder.
769
- if (args !== undefined && args !== null) {
770
- const callEntry = state.entries.find(
771
- (entry) =>
772
- entry.id === existing.callEntryId && entry.type === "tool-call",
773
- );
774
- if (
775
- callEntry &&
776
- callEntry.type === "tool-call" &&
777
- (callEntry.args === undefined || callEntry.args === null)
778
- ) {
779
- callEntry.args =
780
- oversizedToolArgs(args, state.toolArgsCharLimit) ?? args;
781
- }
782
- }
783
- return existing;
784
- }
785
- const callEntry = appendEntry(state, {
786
- type: "tool-call",
787
- turnId,
788
- toolCallId,
789
- toolName,
790
- args: oversizedToolArgs(args, state.toolArgsCharLimit) ?? args,
791
- });
792
- const record = { turnId, callEntryId: callEntry.id };
793
- state.toolCalls.set(toolCallId, record);
794
- return record;
795
- }
796
-
797
- function findActiveAssistantEntry(
798
- state: TranscriptState,
799
- entryId: number | undefined,
800
- type: "thinking" | "assistant-text",
801
- ):
802
- | Extract<TranscriptEntry, { type: "thinking" | "assistant-text" }>
803
- | undefined {
804
- if (entryId === undefined) return undefined;
805
- const entry = state.entries.find((candidate) => candidate.id === entryId);
806
- return entry?.type === type ? entry : undefined;
807
- }
808
-
809
- function updateActiveAssistantText(
810
- state: TranscriptState,
811
- segment: ActiveAssistantSegment,
812
- type: "thinking" | "assistant-text",
813
- text: string,
814
- streaming: boolean,
815
- ): void {
816
- if (!text) return;
817
- const entryId =
818
- type === "thinking" ? segment.thinkingEntryId : segment.textEntryId;
819
- const existing = findActiveAssistantEntry(state, entryId, type);
820
- if (existing) {
821
- existing.text = text;
822
- existing.streaming = streaming;
823
- return;
824
- }
825
-
826
- const entry = appendEntry(state, {
827
- type,
828
- turnId: segment.turnId,
829
- text,
830
- streaming,
831
- });
832
- if (type === "thinking") segment.thinkingEntryId = entry.id;
833
- else segment.textEntryId = entry.id;
834
- }
835
-
836
- function ensureActiveAssistantSegment(
837
- state: TranscriptState,
838
- turnId: number,
839
- startNew: boolean,
840
- ): ActiveAssistantSegment {
841
- if (startNew || state.activeAssistant?.turnId !== turnId) {
842
- state.activeAssistant = { turnId };
843
- }
844
- return state.activeAssistant;
845
- }
846
-
847
- function finishActiveAssistantSegment(state: TranscriptState): void {
848
- const segment = state.activeAssistant;
849
- if (!segment) return;
850
- const thinking = findActiveAssistantEntry(
851
- state,
852
- segment.thinkingEntryId,
853
- "thinking",
854
- );
855
- if (thinking) thinking.streaming = false;
856
- const text = findActiveAssistantEntry(
857
- state,
858
- segment.textEntryId,
859
- "assistant-text",
860
- );
861
- if (text) text.streaming = false;
862
- state.activeAssistant = null;
863
- }
864
-
865
- /**
866
- * Inserts or updates the thinking/assistant-text entry for `turnId`.
867
- * Repeated records for the same turn merge into one entry (latest text wins).
868
- * Public building block for hosts that replay the *same* completed message
869
- * several times (live message updates persisted line by line).
870
- *
871
- * Hosts replaying *distinct* assistant messages inside one turn must use
872
- * `appendText` / `appendAssistantMessage` instead: a turn that contains
873
- * several persisted assistant messages would otherwise keep only the last one.
874
- */
875
- export function upsertText(
876
- state: TranscriptState,
877
- turnId: number,
878
- type: "thinking" | "assistant-text",
879
- text: string,
880
- streaming: boolean,
881
- ): void {
882
- if (!text) return;
883
- const existing = findLatestEntry(state, turnId, type);
884
- if (existing) {
885
- existing.text = text;
886
- existing.streaming = streaming;
887
- return;
888
- }
889
- appendEntry(state, { type, turnId, text, streaming });
890
- }
891
-
892
- /**
893
- * Appends a thinking/assistant-text entry for `turnId` without merging into
894
- * any previous entry of the same type. Public building block for hosts that
895
- * replay finished transcripts, where every persisted assistant message is a
896
- * distinct entry even when several of them share one turn.
897
- */
898
- export function appendText(
899
- state: TranscriptState,
900
- turnId: number,
901
- type: "thinking" | "assistant-text",
902
- text: string,
903
- streaming = false,
904
- ): TranscriptEntry | undefined {
905
- if (!text) return undefined;
906
- return appendEntry(state, { type, turnId, text, streaming });
907
- }
908
-
909
- /**
910
- * Appends one completed assistant message as its own thinking and/or
911
- * assistant-text entries, in the order Pi renders them inside a message.
912
- * Unlike `upsertText` it never overwrites an earlier message of the same
913
- * turn, so history replay keeps every assistant message and thinking block.
914
- */
915
- export function appendAssistantMessage(
916
- state: TranscriptState,
917
- turnId: number,
918
- message: { thinking?: string; text?: string },
919
- streaming = false,
920
- ): { thinkingEntryId?: number; textEntryId?: number } {
921
- const result: { thinkingEntryId?: number; textEntryId?: number } = {};
922
- const thinking = appendText(
923
- state,
924
- turnId,
925
- "thinking",
926
- message.thinking ?? "",
927
- streaming,
928
- );
929
- if (thinking) result.thinkingEntryId = thinking.id;
930
- const text = appendText(
931
- state,
932
- turnId,
933
- "assistant-text",
934
- message.text ?? "",
935
- streaming,
936
- );
937
- if (text) result.textEntryId = text.id;
938
- return result;
939
- }
940
-
941
- /**
942
- * Inserts or updates the structured result of a tool call, creating the call
943
- * placeholder first when the result arrives before its start event. Safe to
944
- * call repeatedly — the latest result wins and streaming flags update in place.
945
- * Public building block for hosts that ingest persisted tool results.
946
- */
947
- export function upsertToolResult(
948
- state: TranscriptState,
949
- turnId: number,
950
- toolCallId: string,
951
- toolName: string,
952
- result: TranscriptToolResultPayload | null,
953
- isError: boolean,
954
- streaming: boolean,
955
- ): void {
956
- const toolCall = ensureToolCall(
957
- state,
958
- turnId,
959
- toolCallId,
960
- toolName,
961
- undefined,
962
- );
963
- const existing =
964
- toolCall.resultEntryId === undefined
965
- ? undefined
966
- : state.entries.find(
967
- (entry) =>
968
- entry.id === toolCall.resultEntryId && entry.type === "tool-result",
969
- );
970
- if (existing && existing.type === "tool-result") {
971
- existing.result = result;
972
- existing.isError = isError;
973
- existing.streaming = streaming;
974
- return;
975
- }
976
- const resultEntry = appendEntry(state, {
977
- type: "tool-result",
978
- turnId,
979
- toolCallId,
980
- toolName,
981
- result,
982
- isError,
983
- streaming,
984
- });
985
- toolCall.resultEntryId = resultEntry.id;
986
- }
987
-
988
- /**
989
- * Appends a notice attached to the current turn (or the most recent one).
990
- * Text is sanitized before storage. Public building block for hosts that
991
- * surface stderr output, retry banners, or other non-conversation events.
992
- */
993
- export function appendNotice(
994
- state: TranscriptState,
995
- text: string,
996
- tone: TranscriptNoticeTone,
997
- ): void {
998
- const turnId = state.currentTurnId ?? state.lastTurnId ?? ensureTurn(state);
999
- appendEntry(state, {
1000
- type: "notice",
1001
- turnId,
1002
- text: safeTerminalText(text),
1003
- tone,
1004
- });
1005
- }
1006
-
1007
- function entryLength(entry: TranscriptEntry): number {
1008
- switch (entry.type) {
1009
- case "user-message":
1010
- case "thinking":
1011
- case "assistant-text":
1012
- case "notice":
1013
- return entry.text.length;
1014
- case "tool-call":
1015
- return entry.toolName.length + jsonSize(entry.args);
1016
- case "tool-result":
1017
- return entry.toolName.length + estimateToolResultSize(entry.result);
1018
- default:
1019
- return 0;
1020
- }
1021
- }
1022
-
1023
- function pruneToolCallIndex(state: TranscriptState): void {
1024
- const entryIds = new Set(state.entries.map((entry) => entry.id));
1025
- const aliveToolCallIds = new Set<string>();
1026
- for (const [toolCallId, record] of state.toolCalls.entries()) {
1027
- if (!entryIds.has(record.callEntryId)) {
1028
- state.toolCalls.delete(toolCallId);
1029
- continue;
1030
- }
1031
- aliveToolCallIds.add(toolCallId);
1032
- if (
1033
- record.resultEntryId !== undefined &&
1034
- !entryIds.has(record.resultEntryId)
1035
- ) {
1036
- record.resultEntryId = undefined;
1037
- }
1038
- }
1039
- // Result entries whose call entry was trimmed away have no renderable
1040
- // position: their visual is owned by the component attached to the call.
1041
- let hasOrphanResults = false;
1042
- for (const entry of state.entries) {
1043
- if (
1044
- entry.type === "tool-result" &&
1045
- !aliveToolCallIds.has(entry.toolCallId)
1046
- ) {
1047
- hasOrphanResults = true;
1048
- break;
1049
- }
1050
- }
1051
- if (hasOrphanResults) {
1052
- state.entries = state.entries.filter(
1053
- (entry) =>
1054
- !(
1055
- entry.type === "tool-result" &&
1056
- !aliveToolCallIds.has(entry.toolCallId)
1057
- ),
1058
- );
1059
- }
1060
- state.toolComponents.retainOnly(aliveToolCallIds);
1061
- }
1062
-
1063
- export function trimTranscriptState(
1064
- state: TranscriptState,
1065
- options: SessionTranscriptOptions = {},
1066
- ): void {
1067
- const maxEntries = Math.max(16, options.maxEntries ?? DEFAULT_MAX_ENTRIES);
1068
- const maxChars = Math.max(1024, options.maxChars ?? DEFAULT_MAX_CHARS);
1069
- while (state.entries.length > maxEntries) state.entries.shift();
1070
- let chars = state.entries.reduce(
1071
- (total, entry) => total + entryLength(entry),
1072
- 0,
1073
- );
1074
- while (chars > maxChars && state.entries.length > 1) {
1075
- const removed = state.entries.shift();
1076
- if (removed) chars -= entryLength(removed);
1077
- }
1078
- pruneToolCallIndex(state);
1079
- }
1080
-
1081
- type SessionEventLike = {
1082
- type?: unknown;
1083
- message?: { role?: unknown; content?: unknown };
1084
- toolCallId?: unknown;
1085
- toolName?: unknown;
1086
- args?: unknown;
1087
- partialResult?: unknown;
1088
- result?: unknown;
1089
- isError?: unknown;
1090
- attempt?: unknown;
1091
- maxAttempts?: unknown;
1092
- delayMs?: unknown;
1093
- errorMessage?: unknown;
1094
- success?: unknown;
1095
- finalError?: unknown;
1096
- };
1097
-
1098
- function eventString(value: unknown, fallback = ""): string {
1099
- return typeof value === "string" && value.trim()
1100
- ? safeTerminalText(value)
1101
- : fallback;
1102
- }
1103
-
1104
- function eventNumber(value: unknown, fallback = 0): number {
1105
- return typeof value === "number" && Number.isFinite(value) ? value : fallback;
1106
- }
1107
-
1108
- type TranscriptMessageEventPhase = "start" | "update" | "end";
1109
-
1110
- function applyTranscriptMessageEvent(
1111
- state: TranscriptState,
1112
- event: SessionEventLike,
1113
- phase: TranscriptMessageEventPhase,
1114
- ): void {
1115
- const message = event.message ?? {};
1116
- if (message.role === "user") {
1117
- const turnId = ensureTurn(state);
1118
- const text = extractMessageText(message);
1119
- if (!text) return;
1120
- const existing = findLatestEntry(state, turnId, "user-message");
1121
- if (existing) existing.text = text;
1122
- else appendEntry(state, { type: "user-message", turnId, text });
1123
- return;
1124
- }
1125
- if (message.role !== "assistant") return;
1126
-
1127
- const turnId = ensureTurn(state);
1128
- const segment = ensureActiveAssistantSegment(
1129
- state,
1130
- turnId,
1131
- phase === "start",
1132
- );
1133
- const streaming = phase !== "end";
1134
- updateActiveAssistantText(
1135
- state,
1136
- segment,
1137
- "thinking",
1138
- extractThinking(message),
1139
- streaming,
1140
- );
1141
- updateActiveAssistantText(
1142
- state,
1143
- segment,
1144
- "assistant-text",
1145
- extractMessageText(message),
1146
- streaming,
1147
- );
1148
- if (phase === "end") finishActiveAssistantSegment(state);
1149
- }
1150
-
1151
- function eventToolCallId(
1152
- state: TranscriptState,
1153
- event: SessionEventLike,
1154
- ): string {
1155
- return eventString(event.toolCallId, `unknown-tool-${state.nextEntryId}`);
1156
- }
1157
-
1158
- function normalizeToolResultPayload(
1159
- value: unknown,
1160
- ): TranscriptToolResultPayload | null {
1161
- if (value === undefined || value === null) return null;
1162
- if (typeof value === "object") return value as TranscriptToolResultPayload;
1163
- if (typeof value === "string")
1164
- return { content: [{ type: "text", text: value }] };
1165
- return { content: [{ type: "text", text: String(value) }] };
1166
- }
1167
-
1168
- function applyTranscriptToolResult(
1169
- state: TranscriptState,
1170
- event: SessionEventLike,
1171
- value: unknown,
1172
- isError: boolean,
1173
- streaming: boolean,
1174
- ): void {
1175
- const toolCallId = eventToolCallId(state, event);
1176
- const toolName = eventString(event.toolName, "tool");
1177
- const turnId = state.toolCalls.get(toolCallId)?.turnId ?? ensureTurn(state);
1178
- const payload = normalizeToolResultPayload(value);
1179
- upsertToolResult(
1180
- state,
1181
- turnId,
1182
- toolCallId,
1183
- toolName,
1184
- payload,
1185
- isError,
1186
- streaming,
1187
- );
1188
- if (streaming) {
1189
- state.toolComponents.handleUpdate(toolCallId, toolName, payload);
1190
- } else {
1191
- state.toolComponents.handleEnd(toolCallId, toolName, payload, isError);
1192
- }
1193
- }
1194
-
1195
- function appendRetryStartNotice(
1196
- state: TranscriptState,
1197
- event: SessionEventLike,
1198
- ): void {
1199
- const attempt = eventNumber(event.attempt);
1200
- const maxAttempts = eventNumber(event.maxAttempts);
1201
- const delaySeconds = Math.max(
1202
- 0,
1203
- Math.ceil(eventNumber(event.delayMs) / 1000),
1204
- );
1205
- const error = eventString(event.errorMessage, "temporary error");
1206
- appendNotice(
1207
- state,
1208
- `Retry ${attempt}/${maxAttempts} in ${delaySeconds}s: ${error}`,
1209
- "warning",
1210
- );
1211
- }
1212
-
1213
- function appendRetryEndNotice(
1214
- state: TranscriptState,
1215
- event: SessionEventLike,
1216
- ): void {
1217
- const attempt = eventNumber(event.attempt);
1218
- if (event.success === true) {
1219
- appendNotice(state, `Retry ${attempt} succeeded.`, "info");
1220
- return;
1221
- }
1222
- const finalError = eventString(event.finalError);
1223
- const message = finalError
1224
- ? `Retry ${attempt} failed: ${finalError}`
1225
- : `Retry ${attempt} failed.`;
1226
- appendNotice(state, message, "error");
1227
- }
1228
-
1229
- export function applyAgentSessionEvent(
1230
- state: TranscriptState,
1231
- input: unknown,
1232
- options: SessionTranscriptOptions = {},
1233
- ): void {
1234
- if (!input || typeof input !== "object") return;
1235
- const event = input as SessionEventLike;
1236
- if (typeof event.type !== "string") return;
1237
- switch (event.type) {
1238
- case "turn_start":
1239
- ensureTurn(state);
1240
- break;
1241
- case "message_start":
1242
- applyTranscriptMessageEvent(state, event, "start");
1243
- break;
1244
- case "message_update":
1245
- applyTranscriptMessageEvent(state, event, "update");
1246
- break;
1247
- case "message_end":
1248
- applyTranscriptMessageEvent(state, event, "end");
1249
- break;
1250
- case "tool_execution_start": {
1251
- const turnId = ensureTurn(state);
1252
- const toolCallId = eventToolCallId(state, event);
1253
- const toolName = eventString(event.toolName, "tool");
1254
- ensureToolCall(state, turnId, toolCallId, toolName, event.args);
1255
- state.toolComponents.handleStart(toolCallId, toolName, event.args);
1256
- break;
1257
- }
1258
- case "tool_execution_update":
1259
- applyTranscriptToolResult(state, event, event.partialResult, false, true);
1260
- break;
1261
- case "tool_execution_end":
1262
- applyTranscriptToolResult(
1263
- state,
1264
- event,
1265
- event.result,
1266
- event.isError === true,
1267
- false,
1268
- );
1269
- break;
1270
- case "turn_end":
1271
- finishTurn(state);
1272
- break;
1273
- case "auto_retry_start":
1274
- appendRetryStartNotice(state, event);
1275
- break;
1276
- case "auto_retry_end":
1277
- appendRetryEndNotice(state, event);
1278
- break;
1279
- default:
1280
- break;
1281
- }
1282
- trimTranscriptState(state, options);
1283
- }
1284
-
1285
- export class SessionTranscript {
1286
- private readonly state: TranscriptState;
1287
- private readonly options: SessionTranscriptOptions;
1288
-
1289
- constructor(options: SessionTranscriptOptions = {}) {
1290
- this.options = options;
1291
- this.state = createTranscriptState(options);
1292
- }
1293
-
1294
- get entries(): readonly TranscriptEntry[] {
1295
- return this.state.entries;
1296
- }
1297
-
1298
- /** Live native tool components keyed by tool call id. */
1299
- get toolComponents(): ToolComponentLookup {
1300
- return this.state.toolComponents;
1301
- }
1302
-
1303
- snapshot(): TranscriptEntry[] {
1304
- return this.state.entries.map((entry) => {
1305
- const copy = { ...entry } as TranscriptEntry;
1306
- if (copy.type === "tool-call") copy.args = cloneStructured(copy.args);
1307
- else if (copy.type === "tool-result") {
1308
- copy.result = cloneStructured(copy.result);
1309
- }
1310
- return copy;
1311
- });
1312
- }
1313
-
1314
- get currentTurnId(): number | null {
1315
- return this.state.currentTurnId;
1316
- }
1317
-
1318
- apply(event: unknown): void {
1319
- applyAgentSessionEvent(this.state, event, this.options);
1320
- }
1321
-
1322
- appendCompletedTurn(details: {
1323
- user?: string;
1324
- thinking?: string;
1325
- assistant: string;
1326
- }): void {
1327
- const turnId = ensureTurn(this.state);
1328
- if (details.user)
1329
- appendEntry(this.state, {
1330
- type: "user-message",
1331
- turnId,
1332
- text: safeTerminalText(details.user),
1333
- });
1334
- if (details.thinking)
1335
- upsertText(
1336
- this.state,
1337
- turnId,
1338
- "thinking",
1339
- safeTerminalText(details.thinking),
1340
- false,
1341
- );
1342
- upsertText(
1343
- this.state,
1344
- turnId,
1345
- "assistant-text",
1346
- safeTerminalText(details.assistant),
1347
- false,
1348
- );
1349
- finishTurn(this.state, turnId);
1350
- trimTranscriptState(this.state, this.options);
1351
- }
1352
-
1353
- appendFailure(message: string): void {
1354
- const turnId =
1355
- this.state.currentTurnId ??
1356
- this.state.lastTurnId ??
1357
- ensureTurn(this.state);
1358
- upsertText(
1359
- this.state,
1360
- turnId,
1361
- "assistant-text",
1362
- `Error: ${safeTerminalText(message)}`,
1363
- false,
1364
- );
1365
- finishTurn(this.state, turnId);
1366
- trimTranscriptState(this.state, this.options);
1367
- }
1368
-
1369
- appendNotice(message: string, tone: TranscriptNoticeTone = "info"): void {
1370
- appendNotice(this.state, message, tone);
1371
- trimTranscriptState(this.state, this.options);
1372
- }
1373
-
1374
- removeCurrentTurn(): void {
1375
- removeTranscriptTurn(
1376
- this.state,
1377
- this.state.currentTurnId ?? this.state.lastTurnId,
1378
- );
1379
- }
1380
-
1381
- clear(): void {
1382
- this.state.entries = [];
1383
- this.state.currentTurnId = null;
1384
- this.state.lastTurnId = null;
1385
- this.state.toolCalls.clear();
1386
- this.state.toolComponents.clear();
1387
- }
1388
- }
1389
-
1390
- export function hasStreamingTranscriptEntry(
1391
- entries: readonly TranscriptEntry[],
1392
- ): boolean {
1393
- return entries.some(
1394
- (entry) =>
1395
- (entry.type === "thinking" ||
1396
- entry.type === "assistant-text" ||
1397
- entry.type === "tool-result") &&
1398
- entry.streaming,
1399
- );
1400
- }
1401
-
1402
- export function getCompletedTranscriptExchangeCount(
1403
- entries: readonly TranscriptEntry[],
1404
- ): number {
1405
- return entries.filter(
1406
- (entry) => entry.type === "assistant-text" && !entry.streaming,
1407
- ).length;
1408
- }
1409
-
1410
- type TranscriptRenderBlock =
1411
- | { kind: "separator" }
1412
- | { kind: "user"; text: string }
1413
- | { kind: "assistant"; thinking: string; text: string }
1414
- | {
1415
- kind: "tool-native";
1416
- toolCallId: string;
1417
- toolName: string;
1418
- args: unknown;
1419
- result: TranscriptToolResultPayload | null;
1420
- isError: boolean;
1421
- streaming: boolean;
1422
- }
1423
- | { kind: "notice"; text: string; tone: TranscriptNoticeTone };
1424
-
1425
- function buildRenderBlocks(
1426
- entries: readonly TranscriptEntry[],
1427
- ): TranscriptRenderBlock[] {
1428
- const blocks: TranscriptRenderBlock[] = [];
1429
- let pendingAssistant:
1430
- | { kind: "assistant"; thinking: string; text: string }
1431
- | undefined;
1432
-
1433
- // Tool results are upserted in place, so the last entry per call id wins.
1434
- // Their visual output is owned by the native component rendered at the call
1435
- // position, so result entries never emit blocks of their own.
1436
- const latestResults = new Map<
1437
- string,
1438
- Extract<TranscriptEntry, { type: "tool-result" }>
1439
- >();
1440
- for (const entry of entries) {
1441
- if (entry.type === "tool-result")
1442
- latestResults.set(entry.toolCallId, entry);
1443
- }
1444
-
1445
- const flushAssistant = (): void => {
1446
- if (!pendingAssistant) return;
1447
- blocks.push(pendingAssistant);
1448
- pendingAssistant = undefined;
1449
- };
1450
- const appendAssistantText = (
1451
- type: "thinking" | "assistant-text",
1452
- text: string,
1453
- ): void => {
1454
- const safeText = safeTerminalText(text);
1455
- if (!safeText) return;
1456
-
1457
- const field = type === "thinking" ? "thinking" : "text";
1458
- if (pendingAssistant?.[field]) flushAssistant();
1459
- if (!pendingAssistant)
1460
- pendingAssistant = { kind: "assistant", thinking: "", text: "" };
1461
- pendingAssistant[field] = safeText;
1462
- };
1463
-
1464
- for (const entry of entries) {
1465
- switch (entry.type) {
1466
- case "turn-boundary":
1467
- flushAssistant();
1468
- if (entry.phase === "start" && blocks.length > 0)
1469
- blocks.push({ kind: "separator" });
1470
- break;
1471
- case "user-message":
1472
- flushAssistant();
1473
- blocks.push({ kind: "user", text: entry.text });
1474
- break;
1475
- case "thinking":
1476
- appendAssistantText("thinking", entry.text);
1477
- break;
1478
- case "assistant-text":
1479
- appendAssistantText("assistant-text", entry.text);
1480
- break;
1481
- case "tool-call": {
1482
- flushAssistant();
1483
- const result = latestResults.get(entry.toolCallId);
1484
- blocks.push({
1485
- kind: "tool-native",
1486
- toolCallId: entry.toolCallId,
1487
- toolName: entry.toolName,
1488
- args: entry.args,
1489
- result: result?.result ?? null,
1490
- isError: result?.isError ?? false,
1491
- streaming: result?.streaming ?? false,
1492
- });
1493
- break;
1494
- }
1495
- case "tool-result":
1496
- break;
1497
- case "notice":
1498
- flushAssistant();
1499
- blocks.push({ kind: "notice", text: entry.text, tone: entry.tone });
1500
- break;
1501
- default:
1502
- break;
1503
- }
1504
- }
1505
- flushAssistant();
1506
- return blocks;
1507
- }
1508
-
1509
- const ESC_SEQUENCE = String.fromCharCode(27);
1510
- const BEL_SEQUENCE = String.fromCharCode(7);
1511
-
1512
- const OSC_133_SEQUENCE = new RegExp(
1513
- `${ESC_SEQUENCE}]133;[ABC]${BEL_SEQUENCE}`,
1514
- "g",
1515
- );
1516
-
1517
- type PresentationAssistantMessage = NonNullable<
1518
- ConstructorParameters<typeof AssistantMessageComponent>[0]
1519
- >;
1520
-
1521
- function stripOsc133(lines: readonly string[]): string[] {
1522
- return lines.map((line) => line.replace(OSC_133_SEQUENCE, ""));
1523
- }
1524
-
1525
- function createPresentationAssistantMessage(
1526
- thinking: string,
1527
- text: string,
1528
- ): PresentationAssistantMessage {
1529
- const content = [
1530
- ...(thinking
1531
- ? [{ type: "thinking" as const, thinking: safeTerminalText(thinking) }]
1532
- : []),
1533
- ...(text ? [{ type: "text" as const, text: safeTerminalText(text) }] : []),
1534
- ];
1535
-
1536
- // Pi's renderer reads only role/content. A transcript can merge events that
1537
- // have no single provider response, so it intentionally has no transport metadata.
1538
- return { role: "assistant", content } as PresentationAssistantMessage;
1539
- }
1540
-
1541
- function renderNativeUserMessage(text: string, width: number): string[] {
1542
- return stripOsc133(
1543
- new UserMessageComponent(
1544
- safeTerminalText(text),
1545
- getMarkdownTheme(),
1546
- 1,
1547
- ).render(width),
1548
- );
1549
- }
1550
-
1551
- function renderNativeAssistantMessage(
1552
- thinking: string,
1553
- text: string,
1554
- width: number,
1555
- thinkingLabel: string,
1556
- hideThinkingBlock: boolean,
1557
- ): string[] {
1558
- return stripOsc133(
1559
- new AssistantMessageComponent(
1560
- createPresentationAssistantMessage(thinking, text),
1561
- hideThinkingBlock,
1562
- getMarkdownTheme(),
1563
- thinkingLabel,
1564
- 1,
1565
- ).render(width),
1566
- );
1567
- }
1568
-
1569
- function wrapRenderedLines(
1570
- lines: readonly string[],
1571
- width: number,
1572
- verbatimLines?: ReadonlySet<number>,
1573
- ): string[] {
1574
- const wrapped: string[] = [];
1575
- for (const [index, line] of lines.entries()) {
1576
- // Native tool components own their geometry (diffs, borders, tables);
1577
- // re-wrapping their output would corrupt it, same as Pi's main transcript.
1578
- if (verbatimLines?.has(index)) {
1579
- wrapped.push(line);
1580
- continue;
1581
- }
1582
- if (line) wrapped.push(...wrapTextWithAnsi(line, Math.max(1, width)));
1583
- else wrapped.push("");
1584
- }
1585
- return wrapped;
1586
- }
1587
-
1588
- function noticeToneColor(tone: TranscriptNoticeTone): ThemeColor {
1589
- switch (tone) {
1590
- case "error":
1591
- return "error";
1592
- case "warning":
1593
- return "warning";
1594
- default:
1595
- return "dim";
1596
- }
1597
- }
1598
-
1599
- export interface TranscriptRenderOptions {
1600
- width: number;
1601
- theme: Theme;
1602
- emptyText?: string;
1603
- assistantLabel?: string;
1604
- /** Collapsed-label text used when `hideThinkingBlock` is enabled. */
1605
- thinkingLabel?: string;
1606
- /**
1607
- * Render assistant thinking blocks collapsed to `thinkingLabel`. Defaults to
1608
- * `false` (expanded), so existing hosts keep Pi's default transcript
1609
- * behavior; hosts that own their own expansion gesture opt in.
1610
- */
1611
- hideThinkingBlock?: boolean;
1612
- assistantBadgeBackground?: ThemeBackground;
1613
- assistantBadgeForeground?: ThemeColor;
1614
- /**
1615
- * Live native tool components keyed by tool call id. When omitted, tool
1616
- * blocks are rendered through stateless ad-hoc components rebuilt from the
1617
- * entry data on every frame.
1618
- */
1619
- toolComponents?: ToolComponentLookup;
1620
- }
1621
-
1622
- /**
1623
- * Builds a stateless component for tool blocks rendered without a live
1624
- * registry (direct API use). Rebuilt per frame; correct output, no incremental
1625
- * renderer state.
1626
- */
1627
- function createAdHocToolComponent(
1628
- block: Extract<TranscriptRenderBlock, { kind: "tool-native" }>,
1629
- ): ToolExecutionComponent {
1630
- const component = new ToolExecutionComponent(
1631
- block.toolName,
1632
- block.toolCallId,
1633
- block.args ?? {},
1634
- {},
1635
- undefined,
1636
- // Only requestRender is ever invoked on the host TUI.
1637
- DETACHED_TUI as NativeToolTui,
1638
- process.cwd(),
1639
- );
1640
- component.setArgsComplete();
1641
- component.markExecutionStarted();
1642
- if (block.result) {
1643
- component.updateResult(
1644
- toComponentResult(block.result, block.isError),
1645
- block.streaming,
1646
- );
1647
- }
1648
- return component;
1649
- }
1650
-
1651
- /**
1652
- * Render normalized transcript entries as terminal lines. User and assistant
1653
- * messages deliberately use Pi's native components so markdown, code,
1654
- * thinking, and message theming stay consistent with the main transcript.
1655
- * Tool calls are rendered by Pi's native `ToolExecutionComponent`, giving
1656
- * built-in tools their familiar rich output (diffs, file previews, images).
1657
- */
1658
- export function renderTranscriptLines(
1659
- entries: readonly TranscriptEntry[],
1660
- options: TranscriptRenderOptions,
1661
- ): string[] {
1662
- const width = Math.max(1, options.width);
1663
- const { theme } = options;
1664
- if (entries.length === 0)
1665
- return [theme.fg("dim", options.emptyText ?? "No transcript yet.")];
1666
-
1667
- const lines: string[] = [];
1668
- const verbatimLines = new Set<number>();
1669
- const pushVerbatim = (rendered: readonly string[]): void => {
1670
- for (const line of rendered) {
1671
- verbatimLines.add(lines.length);
1672
- lines.push(line);
1673
- }
1674
- };
1675
- const assistantBadge = theme.bg(
1676
- options.assistantBadgeBackground ?? "customMessageBg",
1677
- theme.fg(
1678
- options.assistantBadgeForeground ?? "success",
1679
- theme.bold(` ${options.assistantLabel ?? "Assistant"} `),
1680
- ),
1681
- );
1682
- const separator = theme.fg(
1683
- "borderMuted",
1684
- "────────────────────────────────────────",
1685
- );
1686
-
1687
- const blankBefore = (): void => {
1688
- if (lines.length > 0 && lines.at(-1) !== "") lines.push("");
1689
- };
1690
-
1691
- for (const block of buildRenderBlocks(entries)) {
1692
- switch (block.kind) {
1693
- case "separator":
1694
- blankBefore();
1695
- lines.push(separator);
1696
- break;
1697
- case "user":
1698
- lines.push(...renderNativeUserMessage(block.text, width));
1699
- break;
1700
- case "assistant":
1701
- blankBefore();
1702
- lines.push(assistantBadge);
1703
- lines.push(
1704
- ...renderNativeAssistantMessage(
1705
- block.thinking,
1706
- block.text,
1707
- width,
1708
- options.thinkingLabel ?? "Thinking",
1709
- options.hideThinkingBlock === true,
1710
- ),
1711
- );
1712
- break;
1713
- case "tool-native": {
1714
- blankBefore();
1715
- const component =
1716
- options.toolComponents?.get(block.toolCallId) ??
1717
- createAdHocToolComponent(block);
1718
- pushVerbatim(component.render(width));
1719
- break;
1720
- }
1721
- case "notice": {
1722
- blankBefore();
1723
- const color = noticeToneColor(block.tone);
1724
- for (const noticeLine of safeTerminalText(block.text).split("\n"))
1725
- lines.push(theme.fg(color, noticeLine));
1726
- break;
1727
- }
1728
- default:
1729
- break;
1730
- }
1731
- }
1732
-
1733
- // wrapRenderedLines preserves length for verbatim lines, so indices stay
1734
- // aligned for the width-truncation pass below.
1735
- const wrapped = wrapRenderedLines(lines, width, verbatimLines);
1736
- return wrapped.map((line, index) =>
1737
- verbatimLines.has(index) || visibleWidth(line) <= width
1738
- ? line
1739
- : truncateToWidth(line, width, ""),
1740
- );
1741
- }
1742
-
1743
- export interface TranscriptViewportOptions
1744
- extends Omit<TranscriptRenderOptions, "width"> {
1745
- tui: TranscriptTui;
1746
- readEntries: () => readonly TranscriptEntry[];
1747
- }
1748
-
1749
- export interface TranscriptViewportRender {
1750
- lines: string[];
1751
- hiddenAbove: number;
1752
- hiddenBelow: number;
1753
- totalLines: number;
1754
- following: boolean;
1755
- }
1756
-
1757
- /**
1758
- * Decodes an SGR mouse-wheel event into a transcript line delta.
1759
- * Hosts remain responsible for enabling terminal mouse reporting when their
1760
- * TUI mode does not already provide it.
1761
- */
1762
- export function getTranscriptMouseScrollDelta(data: string): number | null {
1763
- const match = data.match(
1764
- new RegExp(`^${ESC_SEQUENCE}\\[<(\\d+);\\d+;\\d+[Mm]$`),
1765
- );
1766
- if (!match) return null;
1767
-
1768
- const button = Number(match[1]);
1769
- if ((button & 64) !== 64) return null;
1770
- return (button & 1) === 0 ? -3 : 3;
1771
- }
1772
-
1773
- /**
1774
- * Stateful scrolling viewport for a transcript. It owns no dialog chrome, so
1775
- * extensions can compose it into their own overlay layout and controls.
1776
- */
1777
- export class TranscriptViewport {
1778
- private readonly tui: TranscriptTui;
1779
- private readonly readEntries: () => readonly TranscriptEntry[];
1780
- private readonly renderOptions: Omit<TranscriptRenderOptions, "width">;
1781
- private scrollOffset = 0;
1782
- private viewportHeight = 8;
1783
- private totalLines = 0;
1784
- private follow = true;
1785
-
1786
- constructor(options: TranscriptViewportOptions) {
1787
- this.tui = options.tui;
1788
- this.readEntries = options.readEntries;
1789
- const { tui: _tui, readEntries: _readEntries, ...renderOptions } = options;
1790
- this.renderOptions = renderOptions;
1791
- }
1792
-
1793
- get following(): boolean {
1794
- return this.follow;
1795
- }
1796
-
1797
- refresh(): void {
1798
- this.tui.requestRender();
1799
- }
1800
-
1801
- scroll(delta: number): void {
1802
- if (delta < 0) this.follow = false;
1803
- const maxScroll = Math.max(0, this.totalLines - this.viewportHeight);
1804
- this.scrollOffset = Math.max(
1805
- 0,
1806
- Math.min(maxScroll, this.scrollOffset + delta),
1807
- );
1808
- if (this.scrollOffset >= maxScroll) this.follow = true;
1809
- this.tui.requestRender();
1810
- }
1811
-
1812
- followLatest(): void {
1813
- this.follow = true;
1814
- this.scrollOffset = Math.max(0, this.totalLines - this.viewportHeight);
1815
- this.tui.requestRender();
1816
- }
1817
-
1818
- handleInput(data: string): boolean {
1819
- const mouseScrollDelta = getTranscriptMouseScrollDelta(data);
1820
- if (mouseScrollDelta !== null) {
1821
- this.scroll(mouseScrollDelta);
1822
- return true;
1823
- }
1824
- if (matchesKey(data, "up") || matchesKey(data, "k")) {
1825
- this.scroll(-1);
1826
- return true;
1827
- }
1828
- if (matchesKey(data, "down") || matchesKey(data, "j")) {
1829
- this.scroll(1);
1830
- return true;
1831
- }
1832
- if (matchesKey(data, "pageUp")) {
1833
- this.scroll(-Math.max(1, this.viewportHeight - 1));
1834
- return true;
1835
- }
1836
- if (matchesKey(data, "pageDown")) {
1837
- this.scroll(Math.max(1, this.viewportHeight - 1));
1838
- return true;
1839
- }
1840
- if (matchesKey(data, "home")) {
1841
- this.follow = false;
1842
- this.scrollOffset = 0;
1843
- this.tui.requestRender();
1844
- return true;
1845
- }
1846
- if (matchesKey(data, "end")) {
1847
- this.followLatest();
1848
- return true;
1849
- }
1850
- return false;
1851
- }
1852
-
1853
- render(width: number, height: number): TranscriptViewportRender {
1854
- const lines = renderTranscriptLines(this.readEntries(), {
1855
- ...this.renderOptions,
1856
- width,
1857
- });
1858
- this.viewportHeight = Math.max(1, height);
1859
- this.totalLines = lines.length;
1860
- const maxScroll = Math.max(0, lines.length - this.viewportHeight);
1861
- if (this.follow) this.scrollOffset = maxScroll;
1862
- else {
1863
- this.scrollOffset = Math.max(0, Math.min(this.scrollOffset, maxScroll));
1864
- if (this.scrollOffset >= maxScroll) this.follow = true;
1865
- }
1866
- const visible = lines.slice(
1867
- this.scrollOffset,
1868
- this.scrollOffset + this.viewportHeight,
1869
- );
1870
- return {
1871
- lines: visible,
1872
- hiddenAbove: this.scrollOffset,
1873
- hiddenBelow: Math.max(0, maxScroll - this.scrollOffset),
1874
- totalLines: lines.length,
1875
- following: this.follow,
1876
- };
1877
- }
1878
- }