@xzzpig/pi-subagents 0.21.0 → 0.24.0

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