@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.21

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 (359) hide show
  1. package/CHANGELOG.md +292 -0
  2. package/README.md +8 -11
  3. package/docs/prefix-cache-architecture.md +14 -0
  4. package/package.json +22 -24
  5. package/packages/ask-user/README.md +55 -107
  6. package/packages/ask-user/ask-ui.ts +306 -732
  7. package/packages/ask-user/clipboard.ts +50 -0
  8. package/packages/ask-user/config.ts +74 -78
  9. package/packages/ask-user/package.json +2 -2
  10. package/packages/ask-user/questions.ts +151 -0
  11. package/packages/ask-user/skills/ask-user/SKILL.md +59 -133
  12. package/packages/ask-user/tools.ts +198 -432
  13. package/packages/autocomplete/package.json +1 -1
  14. package/packages/autocomplete/src/constants.ts +38 -43
  15. package/packages/autocomplete/src/sorting.ts +8 -0
  16. package/packages/background-tasks/package.json +2 -2
  17. package/packages/background-tasks/src/config.ts +0 -73
  18. package/packages/background-tasks/src/index.ts +20 -16
  19. package/packages/background-tasks/src/registry.ts +1 -171
  20. package/packages/background-tasks/src/types.ts +0 -32
  21. package/packages/btw/README.md +13 -56
  22. package/packages/btw/extensions/btw.ts +403 -1796
  23. package/packages/btw/package.json +5 -2
  24. package/packages/btw/skills/btw/SKILL.md +7 -143
  25. package/packages/compactor/README.md +56 -287
  26. package/packages/compactor/package.json +5 -9
  27. package/packages/compactor/skills/compactor/SKILL.md +13 -20
  28. package/packages/compactor/src/card.ts +90 -0
  29. package/packages/compactor/src/commands/index.ts +73 -130
  30. package/packages/compactor/src/compaction/compact-args.ts +5 -3
  31. package/packages/compactor/src/compaction/filter-noise.ts +1 -1
  32. package/packages/compactor/src/compaction/hooks.ts +487 -311
  33. package/packages/compactor/src/compaction/source.ts +178 -0
  34. package/packages/compactor/src/compaction/summarize.ts +586 -52
  35. package/packages/compactor/src/config/manager.ts +130 -127
  36. package/packages/compactor/src/config/schema.ts +32 -48
  37. package/packages/compactor/src/index.ts +40 -431
  38. package/packages/compactor/src/info-screen.ts +44 -190
  39. package/packages/compactor/src/session/recall-blocks.ts +1 -1
  40. package/packages/compactor/src/stats.ts +76 -0
  41. package/packages/compactor/src/tools/context-budget.ts +17 -34
  42. package/packages/compactor/src/tools/ctx-doctor.ts +45 -36
  43. package/packages/compactor/src/tools/register.ts +29 -269
  44. package/packages/compactor/src/types.ts +47 -186
  45. package/packages/core/README.md +25 -0
  46. package/packages/core/child-agent.ts +1 -0
  47. package/packages/core/command-echo.ts +63 -0
  48. package/packages/core/compaction-context.ts +41 -0
  49. package/packages/core/constants.ts +8 -38
  50. package/packages/core/events.ts +0 -53
  51. package/packages/core/fusion-status.ts +4 -0
  52. package/packages/core/global.d.ts +10 -0
  53. package/packages/core/harness-messages.ts +392 -0
  54. package/packages/core/index.ts +14 -0
  55. package/packages/core/kanboard-status.ts +49 -0
  56. package/packages/core/long-horizon-owner-status.ts +46 -0
  57. package/packages/core/model-cache.ts +81 -7
  58. package/packages/core/package.json +6 -3
  59. package/packages/core/src/attach/detect.ts +163 -0
  60. package/packages/core/src/child-agent/child-args.ts +31 -0
  61. package/packages/core/src/child-agent/delivery.ts +41 -0
  62. package/packages/core/src/child-agent/index.ts +5 -0
  63. package/packages/core/src/child-agent/readers.ts +203 -0
  64. package/packages/core/src/child-agent/runtime.ts +584 -0
  65. package/packages/core/src/evidence.ts +78 -0
  66. package/packages/core/src/hints/browser.ts +278 -0
  67. package/packages/core/src/hints/crab-data.ts +19 -0
  68. package/packages/core/src/hints/index.ts +865 -0
  69. package/packages/core/src/hints/lines.ts +607 -0
  70. package/packages/core/src/hints/store.ts +120 -0
  71. package/packages/core/src/jev/chatter.ts +24 -0
  72. package/packages/core/src/jev/settings.ts +177 -14
  73. package/packages/core/src/package-colors.ts +2 -0
  74. package/packages/core/src/settings/catalog.ts +39 -15
  75. package/packages/core/src/settings/engine.ts +48 -2
  76. package/packages/core/src/settings/hub.ts +83 -20
  77. package/packages/core/src/settings/open.ts +49 -0
  78. package/packages/core/src/settings/schema.ts +27 -7
  79. package/packages/core/src/tui/hub-kit.ts +18 -5
  80. package/packages/core/src/tui/kit.ts +198 -0
  81. package/packages/core/src/tui/progress.ts +73 -0
  82. package/packages/core/src/turn/arbiter.ts +290 -0
  83. package/packages/footer/README.md +4 -6
  84. package/packages/footer/package.json +3 -3
  85. package/packages/footer/src/glance-editor.ts +19 -11
  86. package/packages/footer/src/help.ts +1 -1
  87. package/packages/footer/src/index.ts +36 -3
  88. package/packages/footer/src/presets.ts +3 -4
  89. package/packages/footer/src/rendering/icons.ts +0 -20
  90. package/packages/footer/src/segments/compactor.ts +52 -142
  91. package/packages/footer/src/segments/status-ext.ts +0 -1
  92. package/packages/fusion/README.md +14 -4
  93. package/packages/fusion/package.json +4 -3
  94. package/packages/fusion/src/child-args.ts +1 -0
  95. package/packages/fusion/src/index.ts +161 -8
  96. package/packages/fusion/src/pi-settings.ts +57 -0
  97. package/packages/fusion/src/picker.ts +186 -51
  98. package/packages/fusion/src/preset.ts +56 -2
  99. package/packages/fusion/src/prompts.ts +1 -1
  100. package/packages/fusion/src/sidekick-runtime.ts +1 -420
  101. package/packages/fusion/src/tools.ts +107 -128
  102. package/packages/fusion/src/transcript.ts +27 -85
  103. package/packages/info-screen/package.json +2 -2
  104. package/packages/input-shortcuts/README.md +18 -30
  105. package/packages/input-shortcuts/package.json +2 -2
  106. package/packages/input-shortcuts/src/burst.ts +88 -0
  107. package/packages/input-shortcuts/src/chord-overlay.ts +20 -70
  108. package/packages/input-shortcuts/src/cleared-input.ts +97 -0
  109. package/packages/input-shortcuts/src/index.ts +99 -193
  110. package/packages/input-shortcuts/src/last-response.ts +40 -0
  111. package/packages/input-shortcuts/src/registers.ts +8 -23
  112. package/packages/input-shortcuts/src/types.ts +4 -16
  113. package/packages/input-shortcuts/src/undo-redo.ts +59 -47
  114. package/packages/kanboard/README.md +51 -47
  115. package/packages/kanboard/index.ts +293 -55
  116. package/packages/kanboard/package.json +8 -8
  117. package/packages/kanboard/skills/kanboard/SKILL.md +61 -27
  118. package/packages/kanboard/src/badges.ts +93 -0
  119. package/packages/kanboard/src/bin.ts +4 -2
  120. package/packages/kanboard/src/commands.ts +218 -84
  121. package/packages/kanboard/src/debug.ts +20 -0
  122. package/packages/kanboard/src/guard.ts +267 -109
  123. package/packages/kanboard/src/monitor.ts +330 -0
  124. package/packages/kanboard/src/notice-buffer.ts +74 -0
  125. package/packages/kanboard/src/progress.ts +27 -0
  126. package/packages/kanboard/src/reminders.ts +234 -0
  127. package/packages/kanboard/src/settings.ts +69 -15
  128. package/packages/kanboard/src/shapes.ts +5 -0
  129. package/packages/long-horizon/index.ts +190 -13
  130. package/packages/long-horizon/package.json +3 -3
  131. package/packages/long-horizon/src/commands.ts +103 -7
  132. package/packages/long-horizon/src/compaction-brief.ts +35 -0
  133. package/packages/long-horizon/src/engine/continuation.ts +84 -15
  134. package/packages/long-horizon/src/engine/goal-state.ts +64 -13
  135. package/packages/long-horizon/src/engine/nudge-stash.ts +71 -0
  136. package/packages/long-horizon/src/engine/ralph.ts +3 -2
  137. package/packages/long-horizon/src/engine/runaway.ts +68 -11
  138. package/packages/long-horizon/src/engine/verifier.ts +19 -0
  139. package/packages/long-horizon/src/gate.ts +37 -12
  140. package/packages/long-horizon/src/judge/resolve.ts +1 -0
  141. package/packages/long-horizon/src/owner.ts +35 -2
  142. package/packages/long-horizon/src/progress.ts +87 -0
  143. package/packages/long-horizon/src/prompts/goal.ts +1 -1
  144. package/packages/long-horizon/src/runtime.ts +172 -18
  145. package/packages/long-horizon/src/settings.ts +54 -39
  146. package/packages/long-horizon/src/tools/goal.ts +6 -0
  147. package/packages/long-horizon/src/tools/graph.ts +1 -1
  148. package/packages/long-horizon/src/tools/swarm.ts +3 -3
  149. package/packages/mcp/package.json +2 -2
  150. package/packages/memory/commands.ts +7 -2
  151. package/packages/memory/index.ts +210 -32
  152. package/packages/memory/package.json +3 -3
  153. package/packages/memory/save-session.ts +264 -0
  154. package/packages/memory/settings.ts +17 -0
  155. package/packages/memory/tools.ts +253 -203
  156. package/packages/notify/package.json +2 -2
  157. package/packages/skill-registry/README.md +53 -16
  158. package/packages/skill-registry/index.ts +230 -0
  159. package/packages/skill-registry/package.json +19 -8
  160. package/packages/skill-registry/src/editor.ts +206 -0
  161. package/packages/skill-registry/src/judge.ts +289 -0
  162. package/packages/skill-registry/src/registry.ts +87 -0
  163. package/packages/skill-registry/src/settings.ts +259 -0
  164. package/packages/skill-registry/src/vault.ts +80 -0
  165. package/packages/subagents/README.md +39 -119
  166. package/packages/subagents/package.json +6 -13
  167. package/packages/subagents/skills/subagents/SKILL.md +18 -42
  168. package/packages/subagents/src/agents.ts +213 -0
  169. package/packages/subagents/src/cards.ts +182 -0
  170. package/packages/subagents/src/index.ts +609 -1084
  171. package/packages/subagents/src/manager.ts +429 -0
  172. package/packages/subagents/src/profiles.ts +130 -0
  173. package/packages/subagents/src/transcript.ts +154 -0
  174. package/packages/subagents/src/ui.ts +389 -0
  175. package/packages/unipi/bundled.js +39756 -45569
  176. package/packages/unipi/index.ts +55 -10
  177. package/packages/updater/package.json +2 -2
  178. package/packages/utility/README.md +76 -69
  179. package/packages/utility/package.json +2 -2
  180. package/packages/utility/skills/image/SKILL.md +37 -0
  181. package/packages/utility/skills/utility/SKILL.md +17 -60
  182. package/packages/utility/src/answer/extract.ts +128 -0
  183. package/packages/utility/src/answer/index.ts +213 -0
  184. package/packages/utility/src/answer/reply.ts +133 -0
  185. package/packages/utility/src/answer/web.ts +167 -0
  186. package/packages/utility/src/attach/index.ts +205 -0
  187. package/packages/utility/src/commands.ts +38 -142
  188. package/packages/utility/src/diagnostics/engine.ts +50 -5
  189. package/packages/utility/src/image/index.ts +33 -0
  190. package/packages/utility/src/image/models.ts +221 -0
  191. package/packages/{image/src → utility/src/image}/recognize.ts +2 -2
  192. package/packages/utility/src/image/settings.ts +178 -0
  193. package/packages/{image/src/image-source.ts → utility/src/image/source.ts} +1 -1
  194. package/packages/utility/src/image/tools.ts +168 -0
  195. package/packages/utility/src/image/transports.ts +186 -0
  196. package/packages/utility/src/index.ts +68 -389
  197. package/packages/utility/src/lifecycle/cleanup.ts +116 -311
  198. package/packages/utility/src/rename/gate.ts +102 -0
  199. package/packages/utility/src/rename/index.ts +191 -0
  200. package/packages/utility/src/rename/session.ts +170 -0
  201. package/packages/utility/src/render/delegated.ts +285 -0
  202. package/packages/utility/src/render/harness.ts +683 -0
  203. package/packages/utility/src/render/parse.ts +156 -0
  204. package/packages/utility/src/render/pi-settings.ts +38 -0
  205. package/packages/utility/src/render/reply-bg.ts +307 -0
  206. package/packages/utility/src/render/simple.ts +724 -0
  207. package/packages/utility/src/render/spacing.ts +235 -0
  208. package/packages/utility/src/render/styled.ts +251 -0
  209. package/packages/utility/src/render/tools.ts +353 -0
  210. package/packages/utility/src/settings.ts +166 -233
  211. package/packages/utility/src/types.ts +1 -222
  212. package/packages/watchdog/index.ts +17 -6
  213. package/packages/watchdog/package.json +3 -3
  214. package/packages/watchdog/src/config.ts +3 -2
  215. package/packages/web-api/package.json +2 -2
  216. package/packages/workflow/README.md +3 -0
  217. package/packages/workflow/index.ts +0 -2
  218. package/packages/workflow/package.json +2 -2
  219. package/packages/workflow/src/permission/decide.ts +6 -4
  220. package/packages/workflow/src/permission/index.ts +17 -7
  221. package/packages/workflow/src/permission/settings.ts +39 -4
  222. package/packages/workflow/src/plan/index.ts +19 -4
  223. package/packages/background-tasks/extensions/delegate-child.ts +0 -1
  224. package/packages/background-tasks/src/context-parent-snapshot.ts +0 -142
  225. package/packages/background-tasks/src/context-token-budget.ts +0 -903
  226. package/packages/background-tasks/src/context-visible-conversation-v2.ts +0 -551
  227. package/packages/background-tasks/src/delegate/artifacts.ts +0 -487
  228. package/packages/background-tasks/src/delegate/budget.ts +0 -415
  229. package/packages/background-tasks/src/delegate/hook-contract-evidence.json +0 -18
  230. package/packages/background-tasks/src/delegate/hook-contract.ts +0 -154
  231. package/packages/background-tasks/src/delegate/launch.ts +0 -484
  232. package/packages/background-tasks/src/delegate/result-package.ts +0 -459
  233. package/packages/background-tasks/src/delegate/runner.ts +0 -430
  234. package/packages/background-tasks/src/delegate/seed.ts +0 -423
  235. package/packages/background-tasks/src/delegate/types.ts +0 -323
  236. package/packages/background-tasks/src/delegate-child-extension.ts +0 -978
  237. package/packages/background-tasks/src/delegate-extension.ts +0 -654
  238. package/packages/background-tasks/src/fixtures/delegate-context-incident.json +0 -17
  239. package/packages/compactor/skills/compactor-detail/SKILL.md +0 -116
  240. package/packages/compactor/skills/compactor-doctor/SKILL.md +0 -71
  241. package/packages/compactor/skills/compactor-stats/SKILL.md +0 -51
  242. package/packages/compactor/src/compaction/build-sections.ts +0 -76
  243. package/packages/compactor/src/compaction/extract/goals.ts +0 -36
  244. package/packages/compactor/src/compaction/extract/preferences.ts +0 -40
  245. package/packages/compactor/src/compaction/format.ts +0 -53
  246. package/packages/compactor/src/compaction/merge.ts +0 -143
  247. package/packages/compactor/src/config/presets.ts +0 -160
  248. package/packages/compactor/src/executor/executor.ts +0 -233
  249. package/packages/compactor/src/executor/runtime.ts +0 -115
  250. package/packages/compactor/src/security/evaluator.ts +0 -89
  251. package/packages/compactor/src/security/policy.ts +0 -96
  252. package/packages/compactor/src/security/scanner.ts +0 -65
  253. package/packages/compactor/src/session/auto-inject.ts +0 -60
  254. package/packages/compactor/src/session/db.ts +0 -325
  255. package/packages/compactor/src/session/extract.ts +0 -144
  256. package/packages/compactor/src/session/resume-inject.ts +0 -64
  257. package/packages/compactor/src/session/snapshot.ts +0 -327
  258. package/packages/compactor/src/tools/ctx-batch-execute.ts +0 -41
  259. package/packages/compactor/src/tools/ctx-execute-file.ts +0 -23
  260. package/packages/compactor/src/tools/ctx-execute.ts +0 -23
  261. package/packages/compactor/src/tools/ctx-stats.ts +0 -96
  262. package/packages/image/README.md +0 -99
  263. package/packages/image/package.json +0 -61
  264. package/packages/image/skills/image/SKILL.md +0 -76
  265. package/packages/image/src/generate.ts +0 -256
  266. package/packages/image/src/index.ts +0 -135
  267. package/packages/image/src/models.ts +0 -519
  268. package/packages/image/src/openai-images-api.ts +0 -282
  269. package/packages/image/src/register-providers.ts +0 -209
  270. package/packages/image/src/settings.ts +0 -173
  271. package/packages/image/src/tools.ts +0 -326
  272. package/packages/input-shortcuts/src/clipboard.ts +0 -119
  273. package/packages/kanboard/src/runner.ts +0 -817
  274. package/packages/skill-registry/skills/auto/SKILL.md +0 -465
  275. package/packages/skill-registry/skills/brainstorm/SKILL.md +0 -219
  276. package/packages/skill-registry/skills/chore-create/SKILL.md +0 -315
  277. package/packages/skill-registry/skills/chore-execute/SKILL.md +0 -314
  278. package/packages/skill-registry/skills/consolidate/SKILL.md +0 -142
  279. package/packages/skill-registry/skills/consultant/SKILL.md +0 -97
  280. package/packages/skill-registry/skills/debug/SKILL.md +0 -228
  281. package/packages/skill-registry/skills/document/SKILL.md +0 -120
  282. package/packages/skill-registry/skills/fix/SKILL.md +0 -212
  283. package/packages/skill-registry/skills/gather-context/SKILL.md +0 -145
  284. package/packages/skill-registry/skills/plan/SKILL.md +0 -231
  285. package/packages/skill-registry/skills/quick-fix/SKILL.md +0 -135
  286. package/packages/skill-registry/skills/quick-work/SKILL.md +0 -110
  287. package/packages/skill-registry/skills/research/SKILL.md +0 -251
  288. package/packages/skill-registry/skills/review-work/SKILL.md +0 -187
  289. package/packages/skill-registry/skills/scan-issues/SKILL.md +0 -195
  290. package/packages/skill-registry/skills/work/SKILL.md +0 -218
  291. package/packages/skill-registry/skills/worktree-create/SKILL.md +0 -69
  292. package/packages/skill-registry/skills/worktree-list/SKILL.md +0 -78
  293. package/packages/skill-registry/skills/worktree-merge/SKILL.md +0 -89
  294. package/packages/subagents/agents/delegate.md +0 -14
  295. package/packages/subagents/agents/oracle.md +0 -78
  296. package/packages/subagents/agents/researcher.md +0 -52
  297. package/packages/subagents/agents/reviewer.md +0 -80
  298. package/packages/subagents/agents/scout.md +0 -50
  299. package/packages/subagents/agents/worker.md +0 -59
  300. package/packages/subagents/prompts/council.md +0 -48
  301. package/packages/subagents/prompts/gather-context-and-clarify.md +0 -13
  302. package/packages/subagents/prompts/parallel-cleanup.md +0 -59
  303. package/packages/subagents/prompts/parallel-research.md +0 -50
  304. package/packages/subagents/prompts/parallel-review.md +0 -54
  305. package/packages/subagents/prompts/review-loop.md +0 -43
  306. package/packages/subagents/skills/council-mode/SKILL.md +0 -230
  307. package/packages/subagents/skills/subagents/references/constraints-and-recipes.md +0 -259
  308. package/packages/subagents/skills/subagents/references/execution-controls.md +0 -454
  309. package/packages/subagents/skills/subagents/references/management-authoring-rpc.md +0 -161
  310. package/packages/subagents/skills/subagents/references/multi-lane-orchestration.md +0 -39
  311. package/packages/subagents/skills/subagents/references/prompting-and-roles.md +0 -267
  312. package/packages/subagents/src/acceptance.ts +0 -331
  313. package/packages/subagents/src/agent-manager.ts +0 -405
  314. package/packages/subagents/src/agent-memory.ts +0 -300
  315. package/packages/subagents/src/agent-overrides.ts +0 -183
  316. package/packages/subagents/src/agent-runner.ts +0 -271
  317. package/packages/subagents/src/async-runner.ts +0 -422
  318. package/packages/subagents/src/authority-policy.ts +0 -47
  319. package/packages/subagents/src/budgets.ts +0 -285
  320. package/packages/subagents/src/child-safety.ts +0 -140
  321. package/packages/subagents/src/config.ts +0 -249
  322. package/packages/subagents/src/conversation-viewer.ts +0 -281
  323. package/packages/subagents/src/core-compat.ts +0 -94
  324. package/packages/subagents/src/custom-agents.ts +0 -343
  325. package/packages/subagents/src/file-system-retry.ts +0 -50
  326. package/packages/subagents/src/fleet-data.ts +0 -105
  327. package/packages/subagents/src/fleet-view.ts +0 -322
  328. package/packages/subagents/src/foreground-detach.ts +0 -59
  329. package/packages/subagents/src/fork-context.ts +0 -285
  330. package/packages/subagents/src/global.d.ts +0 -7
  331. package/packages/subagents/src/guide.ts +0 -129
  332. package/packages/subagents/src/mission-state.ts +0 -133
  333. package/packages/subagents/src/mission-store.ts +0 -436
  334. package/packages/subagents/src/output-limits.ts +0 -142
  335. package/packages/subagents/src/parity-types.ts +0 -315
  336. package/packages/subagents/src/pi-args.ts +0 -167
  337. package/packages/subagents/src/result-files.ts +0 -232
  338. package/packages/subagents/src/result-watcher.ts +0 -221
  339. package/packages/subagents/src/retained-children.ts +0 -176
  340. package/packages/subagents/src/run-fanout-budget.ts +0 -356
  341. package/packages/subagents/src/scheduled-runs.ts +0 -349
  342. package/packages/subagents/src/schemas.ts +0 -263
  343. package/packages/subagents/src/slash-commands.ts +0 -80
  344. package/packages/subagents/src/supervisor-channel.ts +0 -249
  345. package/packages/subagents/src/tool-handler.ts +0 -1144
  346. package/packages/subagents/src/types.ts +0 -238
  347. package/packages/subagents/src/widget.ts +0 -457
  348. package/packages/subagents/src/workflow-script.ts +0 -737
  349. package/packages/subagents/src/workflow-worker.ts +0 -384
  350. package/packages/subagents/src/worktree.ts +0 -614
  351. package/packages/utility/src/analytics/collector.ts +0 -293
  352. package/packages/utility/src/info-screen.ts +0 -80
  353. package/packages/utility/src/lifecycle/process.ts +0 -162
  354. package/packages/utility/src/prefix-cache.ts +0 -263
  355. package/packages/utility/src/skill-discovery.ts +0 -542
  356. package/packages/utility/src/tools/env.ts +0 -113
  357. package/packages/utility/src/tui/name-badge-state.ts +0 -315
  358. package/packages/utility/src/tui/name-badge.ts +0 -109
  359. /package/packages/{subagents/src → core/src/child-agent}/pi-spawn.ts +0 -0
@@ -0,0 +1,154 @@
1
+ /**
2
+ * @pi-unipi/subagents — transcript items for the dock's view and the live
3
+ * foreground card. Sources: the child's session file (full history, survives
4
+ * restarts, covers resumed runs) and the runtime's live events (current run,
5
+ * including in-flight tools and streaming text).
6
+ */
7
+
8
+ import { existsSync, readFileSync, statSync } from "node:fs";
9
+ import type { SidekickEvent } from "@pi-unipi/core/child-agent.js";
10
+
11
+ export type TranscriptItem =
12
+ | { kind: "task"; text: string }
13
+ | { kind: "text"; text: string }
14
+ | { kind: "tool"; name: string; arg: string; output: string; isError: boolean; running: boolean; durationMs?: number };
15
+
16
+ function firstLine(value: string): string {
17
+ return value.split("\n", 1)[0] ?? "";
18
+ }
19
+
20
+ export function clip(value: string, max: number): string {
21
+ return value.length > max ? `${value.slice(0, Math.max(0, max - 1))}…` : value;
22
+ }
23
+
24
+ /** The argument worth showing next to a tool name. */
25
+ export function primaryArg(name: string, args: Record<string, unknown> | undefined): string {
26
+ if (!args) return "";
27
+ const value = name === "bash"
28
+ ? args.command
29
+ : name === "read" || name === "edit" || name === "write"
30
+ ? args.path ?? args.file_path ?? args.filePath
31
+ : args.pattern ?? args.query ?? Object.values(args).find((entry) => typeof entry === "string");
32
+ return typeof value === "string" ? clip(firstLine(value), 100) : "";
33
+ }
34
+
35
+ export function itemsFromEvents(events: readonly SidekickEvent[]): TranscriptItem[] {
36
+ return events.flatMap((event): TranscriptItem[] => {
37
+ if (event.kind === "text") return event.text.trim() ? [{ kind: "text", text: event.text }] : [];
38
+ return [{
39
+ kind: "tool",
40
+ name: event.name,
41
+ arg: primaryArg(event.name, event.args),
42
+ output: event.output,
43
+ isError: event.isError,
44
+ running: !event.done,
45
+ durationMs: event.endedAt !== undefined ? event.endedAt - event.startedAt : undefined,
46
+ }];
47
+ });
48
+ }
49
+
50
+ function textOf(content: unknown): string {
51
+ if (typeof content === "string") return content;
52
+ if (!Array.isArray(content)) return "";
53
+ return content
54
+ .map((part) => (typeof part === "object" && part !== null && (part as { type?: unknown }).type === "text" ? String((part as { text?: unknown }).text ?? "") : ""))
55
+ .filter(Boolean)
56
+ .join("\n");
57
+ }
58
+
59
+ const fileCache = new Map<string, { mtimeMs: number; size: number; items: TranscriptItem[] }>();
60
+
61
+ /** Parse a pi session .jsonl into transcript items (user prompts → task).
62
+ * Cached by mtime+size — the dock re-renders several times a second. */
63
+ export function itemsFromSessionFile(path: string): TranscriptItem[] {
64
+ if (!existsSync(path)) return [];
65
+ try {
66
+ const st = statSync(path);
67
+ const hit = fileCache.get(path);
68
+ if (hit !== undefined && hit.mtimeMs === st.mtimeMs && hit.size === st.size) return hit.items;
69
+ const items = parseSession(readFileSync(path, "utf8"));
70
+ if (fileCache.size > 50) fileCache.clear();
71
+ fileCache.set(path, { mtimeMs: st.mtimeMs, size: st.size, items });
72
+ return items;
73
+ } catch {
74
+ return [];
75
+ }
76
+ }
77
+
78
+ function parseSession(raw: string): TranscriptItem[] {
79
+ const items: TranscriptItem[] = [];
80
+ const tools = new Map<string, Extract<TranscriptItem, { kind: "tool" }>>();
81
+ for (const line of raw.split("\n")) {
82
+ if (!line.trim()) continue;
83
+ let entry: { type?: string; message?: { role?: string; content?: unknown; toolCallId?: string; isError?: boolean } };
84
+ try {
85
+ entry = JSON.parse(line) as typeof entry;
86
+ } catch {
87
+ continue; // a torn last line while the child is writing
88
+ }
89
+ const msg = entry.message;
90
+ if (entry.type !== "message" || !msg) continue;
91
+ if (msg.role === "user") {
92
+ const text = textOf(msg.content).trim();
93
+ if (text) items.push({ kind: "task", text });
94
+ } else if (msg.role === "assistant" && Array.isArray(msg.content)) {
95
+ for (const part of msg.content as Array<Record<string, unknown>>) {
96
+ if (part.type === "text" && typeof part.text === "string" && part.text.trim()) {
97
+ items.push({ kind: "text", text: part.text });
98
+ } else if (part.type === "toolCall") {
99
+ const name = String(part.name ?? "tool");
100
+ const item: Extract<TranscriptItem, { kind: "tool" }> = {
101
+ kind: "tool",
102
+ name,
103
+ arg: primaryArg(name, part.arguments as Record<string, unknown> | undefined),
104
+ output: "",
105
+ isError: false,
106
+ running: true,
107
+ };
108
+ tools.set(String(part.id ?? ""), item);
109
+ items.push(item);
110
+ }
111
+ }
112
+ } else if (msg.role === "toolResult") {
113
+ const item = tools.get(String(msg.toolCallId ?? ""));
114
+ if (item) {
115
+ item.output = textOf(msg.content).slice(-4000);
116
+ item.isError = msg.isError === true;
117
+ item.running = false;
118
+ }
119
+ }
120
+ }
121
+ return items;
122
+ }
123
+
124
+ /**
125
+ * The full transcript of one agent. Finished: the session file (fallback:
126
+ * this process's events). Running: the file up to and including the latest
127
+ * task (history + the current prompt), then the live events of this run —
128
+ * the live events already contain what the file has for the current run.
129
+ */
130
+ export function buildTranscript(input: {
131
+ sessionFile: string;
132
+ task?: string;
133
+ running: boolean;
134
+ events?: readonly SidekickEvent[];
135
+ }): TranscriptItem[] {
136
+ const fromFile = itemsFromSessionFile(input.sessionFile);
137
+ const live = input.events ? itemsFromEvents(input.events) : undefined;
138
+ if (!input.running) {
139
+ if (fromFile.length > 0) return fromFile;
140
+ return [...(input.task ? [{ kind: "task" as const, text: input.task }] : []), ...(live ?? [])];
141
+ }
142
+ let lastTask = -1;
143
+ fromFile.forEach((item, i) => {
144
+ if (item.kind === "task") lastTask = i;
145
+ });
146
+ const last = fromFile[lastTask];
147
+ // The file may not have the current prompt yet: then everything in it is
148
+ // from earlier runs (resume) and the current task comes from the record.
149
+ const current = last?.kind === "task" && (input.task === undefined || last.text === input.task.trim());
150
+ const history = current
151
+ ? fromFile.slice(0, lastTask + 1)
152
+ : [...fromFile, ...(input.task ? [{ kind: "task" as const, text: input.task }] : [])];
153
+ return [...history, ...(live ?? [])];
154
+ }
@@ -0,0 +1,389 @@
1
+ /**
2
+ * @pi-unipi/subagents — TUI: strip, dock (list + transcript view), live tail.
3
+ *
4
+ * Devin layout, UniPi styling:
5
+ * strip (below editor) `◆ 2 subagents (1 running) · ↓ select`
6
+ * dock (replaces editor) `── Subagents ──` rows `❭ DONE Explore title ····· 7s · 1 tool · model`
7
+ * keys `↑↓ navigate · ↵ view · f foreground · x cancel · esc close`
8
+ * view `── ◔ Explore › title ── 2m49s · 8 tools ──`, model line, task, live steps
9
+ */
10
+
11
+ import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
12
+ import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
13
+ import { Key, Markdown, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi, type Component, type TUI } from "@earendil-works/pi-tui";
14
+ import { badge, formatTokens, leader, settledGlyph, spinner, SPINNER_MS, STATE_BADGE, STATE_COLOR, stateGlyph } from "@pi-unipi/core";
15
+ import type { SidekickUsage } from "@pi-unipi/core/child-agent.js";
16
+ import type { SubagentRecord, SubagentStatus } from "./manager.js";
17
+ import type { TranscriptItem } from "./transcript.js";
18
+
19
+ export type ThemeLike = Pick<Theme, "fg" | "bold">;
20
+
21
+ const SPIN_MS = SPINNER_MS;
22
+
23
+ export function elapsed(ms: number): string {
24
+ const s = Math.max(0, Math.floor(ms / 1000));
25
+ if (s < 60) return `${String(s)}s`;
26
+ const m = Math.floor(s / 60);
27
+ if (m < 60) return `${String(m)}m${String(s % 60).padStart(2, "0")}s`;
28
+ return `${String(Math.floor(m / 60))}h${String(m % 60).padStart(2, "0")}m`;
29
+ }
30
+
31
+ export function plural(n: number, word: string): string {
32
+ return `${String(n)} ${word}${n === 1 ? "" : "s"}`;
33
+ }
34
+
35
+ /** subagent_explore → Explore; custom ids keep their name. */
36
+ export function profileLabel(profile: string): string {
37
+ const base = profile.startsWith("subagent_") ? profile.slice("subagent_".length) : profile;
38
+ return base.charAt(0).toUpperCase() + base.slice(1);
39
+ }
40
+
41
+ export const STATUS_LABEL: Record<SubagentStatus, string> = {
42
+ running: "Running",
43
+ completed: "Completed",
44
+ failed: "Failed",
45
+ cancelled: "Cancelled",
46
+ };
47
+
48
+ /** Crafted spinner while running, else ✓ ✗ ⊘ padded to the spinner's width. */
49
+ export function statusGlyph(status: SubagentStatus, theme: ThemeLike, now = Date.now()): string {
50
+ return stateGlyph(theme, status, now);
51
+ }
52
+
53
+ export function statusColor(status: SubagentStatus): ThemeColor {
54
+ return STATE_COLOR[status];
55
+ }
56
+
57
+ /** Inverse chip for a state: RUN / DONE / FAIL / STOP. */
58
+ export function statusBadge(status: SubagentStatus, theme: ThemeLike): string {
59
+ return badge(theme, STATE_COLOR[status], STATE_BADGE[status]);
60
+ }
61
+
62
+ function durationOf(rec: Pick<SubagentRecord, "startedAt" | "endedAt">, now = Date.now()): number {
63
+ return (rec.endedAt ?? now) - rec.startedAt;
64
+ }
65
+
66
+ /** `10k in · 0.2k out · $0.11` — omit zero token counts and unknown cost ($0). */
67
+ export function usageTail(usage: SidekickUsage | undefined): string {
68
+ if (usage === undefined) return "";
69
+ const parts: string[] = [];
70
+ if (usage.input > 0 || usage.output > 0) parts.push(`${formatTokens(usage.input)} in`, `${formatTokens(usage.output)} out`);
71
+ if (usage.cost > 0) parts.push(`$${usage.cost.toFixed(2)}`);
72
+ return parts.length > 0 ? ` · ${parts.join(" · ")}` : "";
73
+ }
74
+
75
+ /**
76
+ * The live stats line for one agent:
77
+ * `Explore · ds/flash · 32s · 20 tool calls · 10k in · 0.2k out · $0.11`.
78
+ */
79
+ export function statLine(
80
+ rec: Pick<SubagentRecord, "profile" | "model" | "startedAt" | "endedAt">,
81
+ toolCalls: number,
82
+ usage: SidekickUsage | undefined,
83
+ now = Date.now(),
84
+ ): string {
85
+ return `${profileLabel(rec.profile)} · ${rec.model} · ${elapsed(durationOf(rec, now))} · ${plural(toolCalls, "tool call")}${usageTail(usage)}`;
86
+ }
87
+
88
+ /** `◆ 2 subagents (1 running) · ↓ select` — undefined when there are none. */
89
+ export function stripText(records: readonly SubagentRecord[], theme: ThemeLike): string | undefined {
90
+ if (records.length === 0) return undefined;
91
+ const running = records.filter((r) => r.status === "running").length;
92
+ const count = plural(records.length, "subagent");
93
+ const run = running > 0 ? ` ${theme.fg("accent", `(${String(running)} running)`)}` : "";
94
+ return `${theme.fg(running > 0 ? "accent" : "muted", "◆")} ${theme.fg("muted", count)}${run}${theme.fg("dim", " · ↓ select")}`;
95
+ }
96
+
97
+ function spinFrame(): number {
98
+ return Date.now();
99
+ }
100
+
101
+ /** Live stats accessor for the strip's per-agent lines. */
102
+ export interface AgentStats {
103
+ toolCalls: number;
104
+ usage?: SidekickUsage;
105
+ }
106
+
107
+ /** Persistent strip under the editor: `◆ 2 subagents (1 running) · ↓ select`
108
+ * plus one stat line per running agent, ticking once a second. */
109
+ export class SubagentStrip implements Component {
110
+ private readonly timer: ReturnType<typeof setInterval>;
111
+
112
+ constructor(
113
+ tui: TUI,
114
+ private readonly theme: ThemeLike,
115
+ private readonly getRecords: () => readonly SubagentRecord[],
116
+ private readonly stats: (rec: SubagentRecord) => AgentStats,
117
+ ) {
118
+ this.timer = setInterval(() => {
119
+ if (this.getRecords().some((r) => r.status === "running")) tui.requestRender();
120
+ }, 1000);
121
+ this.timer.unref?.();
122
+ }
123
+
124
+ invalidate(): void {}
125
+
126
+ dispose(): void {
127
+ clearInterval(this.timer);
128
+ }
129
+
130
+ render(width: number): string[] {
131
+ const text = stripText(this.getRecords(), this.theme);
132
+ if (text === undefined) return [];
133
+ const t = this.theme;
134
+ const lines = [truncateToWidth(text, width)];
135
+ const running = this.getRecords().filter((r) => r.status === "running");
136
+ for (const rec of running.slice(0, 3)) {
137
+ const s = this.stats(rec);
138
+ lines.push(truncateToWidth(` ${spinner(t, undefined)} ${t.fg("dim", statLine(rec, s.toolCalls, s.usage))}`, width));
139
+ }
140
+ if (running.length > 3) lines.push(truncateToWidth(` ${t.fg("dim", `… +${String(running.length - 3)} more`)}`, width));
141
+ return lines;
142
+ }
143
+ }
144
+
145
+ // ── transcript rendering ────────────────────────────────────────────────────
146
+
147
+ const TOOL_OUTPUT_LINES = 3;
148
+
149
+ /** Render transcript items as chat-like lines (tools `●`, text markdown). */
150
+ export function renderItems(items: readonly TranscriptItem[], width: number, theme: ThemeLike, opts: { fullOutput?: boolean; frame?: number } = {}): string[] {
151
+ const w = Math.max(10, width);
152
+ const out: string[] = [];
153
+ for (const item of items) {
154
+ if (item.kind === "task") {
155
+ out.push(theme.fg("dim", "Task"));
156
+ for (const l of item.text.split("\n")) {
157
+ out.push(...wrapTextWithAnsi(theme.fg("muted", l), w - 2).map((x) => ` ${x}`));
158
+ }
159
+ out.push("");
160
+ } else if (item.kind === "text") {
161
+ const md = new Markdown(item.text, 0, 0, getMarkdownTheme()).render(w);
162
+ out.push(...md, "");
163
+ } else {
164
+ const glyph = item.running ? spinner(theme, undefined, opts.frame) : theme.fg(item.isError ? "error" : "accent", settledGlyph(item.isError ? "✗" : "●"));
165
+ const dur = item.durationMs !== undefined && item.durationMs >= 1000 ? theme.fg("dim", ` ${elapsed(item.durationMs)}`) : "";
166
+ out.push(truncateToWidth(`${glyph} ${theme.fg("toolTitle", theme.bold(item.name))}${item.arg ? ` ${theme.fg("accent", item.arg)}` : ""}${dur}`, w));
167
+ const lines = item.output.replace(/\s+$/u, "").split("\n").filter((l, i, a) => l.length > 0 || i < a.length - 1);
168
+ if (lines.length > 0 && lines[0] !== "") {
169
+ const shown = opts.fullOutput ? lines : lines.slice(-TOOL_OUTPUT_LINES);
170
+ if (shown.length < lines.length) out.push(theme.fg("dim", ` … ${String(lines.length - shown.length)} earlier lines`));
171
+ for (const l of shown) out.push(truncateToWidth(` ${theme.fg(item.isError ? "error" : "toolOutput", l)}`, w));
172
+ }
173
+ }
174
+ }
175
+ while (out.at(-1) === "") out.pop();
176
+ return out;
177
+ }
178
+
179
+ /** Last few tool/text lines — the live tail on foreground cards/widgets. */
180
+ export function tailLines(items: readonly TranscriptItem[], width: number, theme: ThemeLike, max = 4): string[] {
181
+ const steps = items.filter((i) => i.kind !== "task").slice(-max);
182
+ const frame = spinFrame();
183
+ return steps.flatMap((item) => {
184
+ if (item.kind === "text") return [truncateToWidth(` ${theme.fg("dim", item.text.replace(/\s+/gu, " ").trim())}`, width)];
185
+ if (item.kind !== "tool") return [];
186
+ const glyph = item.running ? spinner(theme, undefined, frame) : theme.fg(item.isError ? "error" : "dim", settledGlyph(item.isError ? "✗" : "●"));
187
+ const row = truncateToWidth(` ${glyph} ${theme.fg("muted", item.name)}${item.arg ? ` ${theme.fg("dim", item.arg)}` : ""}`, width);
188
+ // A running tool shows its newest output line (bash streams).
189
+ const latest = item.running ? item.output.trimEnd().split("\n").at(-1) : undefined;
190
+ return latest ? [row, truncateToWidth(` ${theme.fg("dim", latest)}`, width)] : [row];
191
+ });
192
+ }
193
+
194
+ // ── dock ────────────────────────────────────────────────────────────────────
195
+
196
+ export interface DockActions {
197
+ records: () => readonly SubagentRecord[];
198
+ transcript: (rec: SubagentRecord) => TranscriptItem[];
199
+ toolCalls: (rec: SubagentRecord) => number;
200
+ usage?: (rec: SubagentRecord) => SidekickUsage | undefined;
201
+ subscribe: (listener: () => void) => () => void;
202
+ foreground: (id: string) => string | undefined;
203
+ cancel: (id: string) => string | undefined;
204
+ }
205
+
206
+ const LIST_HINT = "↑↓ navigate · ↵ view · f foreground · x cancel · esc close";
207
+ const VIEW_HINT = "↑↓ scroll · g/G top/end · o output · f foreground · x cancel · esc back";
208
+ const MAX_LIST_ROWS = 10;
209
+
210
+ function rule(theme: ThemeLike, left: string, right: string, width: number): string {
211
+ const l = `── ${left} `;
212
+ const r = right ? ` ${right} ──` : "";
213
+ const fill = Math.max(2, width - visibleWidth(l) - visibleWidth(r));
214
+ return truncateToWidth(`${theme.fg("borderMuted", "── ")}${left} ${theme.fg("borderMuted", "─".repeat(fill))}${r ? theme.fg("dim", r) : ""}`, width);
215
+ }
216
+
217
+ /** Inline dock (replaces the editor like /unipi:btw). */
218
+ export class SubagentDock implements Component {
219
+ private selected = 0;
220
+ private listTop = 0;
221
+ private viewId: string | undefined;
222
+ private scroll = 0;
223
+ private follow = true;
224
+ private fullOutput = false;
225
+ private flash: string | undefined;
226
+ private readonly unsubscribe: () => void;
227
+ private readonly timer: ReturnType<typeof setInterval>;
228
+
229
+ constructor(
230
+ private readonly tui: TUI,
231
+ private readonly theme: Theme,
232
+ private readonly actions: DockActions,
233
+ private readonly done: () => void,
234
+ initialId?: string,
235
+ ) {
236
+ const recs = this.ordered();
237
+ const first = initialId !== undefined ? recs.findIndex((r) => r.id === initialId) : recs.findIndex((r) => r.status === "running");
238
+ this.selected = Math.max(0, first);
239
+ this.unsubscribe = actions.subscribe(() => this.tui.requestRender());
240
+ this.timer = setInterval(() => {
241
+ if (this.actions.records().some((r) => r.status === "running")) this.tui.requestRender();
242
+ }, SPIN_MS);
243
+ this.timer.unref?.();
244
+ }
245
+
246
+ /** Newest first — what you just started is at the top. */
247
+ private ordered(): SubagentRecord[] {
248
+ return [...this.actions.records()].sort((a, b) => b.startedAt - a.startedAt);
249
+ }
250
+
251
+ private current(): SubagentRecord | undefined {
252
+ const recs = this.ordered();
253
+ if (this.viewId !== undefined) return recs.find((r) => r.id === this.viewId);
254
+ return recs[Math.min(this.selected, recs.length - 1)];
255
+ }
256
+
257
+ invalidate(): void {}
258
+
259
+ dispose(): void {
260
+ clearInterval(this.timer);
261
+ this.unsubscribe();
262
+ }
263
+
264
+ render(width: number): string[] {
265
+ const w = Math.max(30, width);
266
+ return this.viewId !== undefined ? this.renderView(w) : this.renderList(w);
267
+ }
268
+
269
+ private renderList(w: number): string[] {
270
+ const t = this.theme;
271
+ const recs = this.ordered();
272
+ const running = recs.filter((r) => r.status === "running").length;
273
+ const out = [rule(t, t.fg("accent", t.bold("Subagents")), `${String(recs.length)}${running > 0 ? ` · ${String(running)} running` : ""}`, w)];
274
+ if (recs.length === 0) out.push(t.fg("dim", " No subagents in this session yet."));
275
+ this.selected = Math.max(0, Math.min(this.selected, recs.length - 1));
276
+ if (this.selected < this.listTop) this.listTop = this.selected;
277
+ if (this.selected >= this.listTop + MAX_LIST_ROWS) this.listTop = this.selected - MAX_LIST_ROWS + 1;
278
+ if (this.listTop > 0) out.push(t.fg("dim", ` ↑ ${String(this.listTop)} more`));
279
+ const frame = spinFrame();
280
+ for (let i = this.listTop; i < Math.min(recs.length, this.listTop + MAX_LIST_ROWS); i++) {
281
+ const rec = recs[i]!;
282
+ const sel = i === this.selected;
283
+ const calls = this.actions.toolCalls(rec);
284
+ // Badge row: `❭ RUN General title ········ ⢎⡱ 7s · 2 tools · bg · model`
285
+ const left = `${sel ? t.fg("accent", "❭") : " "} ${statusBadge(rec.status, t)} ${t.bold(profileLabel(rec.profile))} ${sel ? t.fg("accent", rec.title) : rec.title}`;
286
+ const tags = [elapsed(durationOf(rec)), plural(calls, "tool")];
287
+ if (rec.status === "running" && rec.background) tags.push("bg");
288
+ tags.push(rec.model);
289
+ const tok = usageTail(this.actions.usage?.(rec));
290
+ if (tok) tags.push(tok.slice(3));
291
+ const live = rec.status === "running" ? `${spinner(t, undefined, frame)} ` : "";
292
+ const right = `${live}${t.fg("dim", tags.join(" · "))}`;
293
+ out.push(visibleWidth(right) + 16 < w ? leader(t, truncateToWidth(left, w - visibleWidth(right) - 4), right, w) : truncateToWidth(left, w));
294
+ }
295
+ const below = recs.length - (this.listTop + MAX_LIST_ROWS);
296
+ if (below > 0) out.push(t.fg("dim", ` ↓ ${String(below)} more`));
297
+ out.push(t.fg("borderMuted", "─".repeat(w)));
298
+ out.push(truncateToWidth(this.flash !== undefined ? `${t.fg("warning", this.flash)} ${t.fg("dim", LIST_HINT)}` : t.fg("dim", LIST_HINT), w));
299
+ return out;
300
+ }
301
+
302
+ private renderView(w: number): string[] {
303
+ const t = this.theme;
304
+ const rec = this.current();
305
+ if (rec === undefined) {
306
+ this.viewId = undefined;
307
+ return this.renderList(w);
308
+ }
309
+ const frame = spinFrame();
310
+ const calls = this.actions.toolCalls(rec);
311
+ const header = rule(t, `${statusGlyph(rec.status, t, frame)} ${t.fg("muted", profileLabel(rec.profile))} ${t.fg("dim", "›")} ${t.bold(rec.title)}`, `${elapsed(durationOf(rec))} · ${plural(calls, "tool")}`, w);
312
+ const meta = [`Model: ${rec.model}${rec.thinking ? ` · ${rec.thinking}` : ""}`, `id ${rec.id}`, rec.status === "running" ? (rec.background ? "background" : "foreground") : t.fg(statusColor(rec.status), STATUS_LABEL[rec.status])];
313
+ const tok = usageTail(this.actions.usage?.(rec));
314
+ if (tok) meta.push(tok.slice(3));
315
+ const body = renderItems(this.actions.transcript(rec), w - 1, t, { fullOutput: this.fullOutput, frame });
316
+ if (rec.status !== "running") {
317
+ if (rec.error) body.push("", t.fg(rec.status === "cancelled" ? "warning" : "error", `${rec.status === "cancelled" ? "⊘" : "✗"} ${rec.error}`));
318
+ else if (rec.status === "cancelled") body.push("", t.fg("warning", `⊘ Cancelled${rec.cancelledBy === "user" ? " by you" : ""}`));
319
+ }
320
+ const viewport = Math.max(5, (process.stdout.rows ?? 30) - 12);
321
+ const maxScroll = Math.max(0, body.length - viewport);
322
+ if (this.follow) this.scroll = maxScroll;
323
+ this.scroll = Math.max(0, Math.min(this.scroll, maxScroll));
324
+ if (this.scroll >= maxScroll) this.follow = true;
325
+ const visible = body.slice(this.scroll, this.scroll + viewport);
326
+ const pos = body.length > viewport ? t.fg("dim", ` ${String(this.scroll + visible.length)}/${String(body.length)}`) : "";
327
+ return [
328
+ header,
329
+ truncateToWidth(t.fg("dim", meta.join(" · ")) + pos, w),
330
+ "",
331
+ ...visible.map((l) => truncateToWidth(l, w)),
332
+ t.fg("borderMuted", "─".repeat(w)),
333
+ truncateToWidth(this.flash !== undefined ? `${t.fg("warning", this.flash)} ${t.fg("dim", VIEW_HINT)}` : t.fg("dim", VIEW_HINT), w),
334
+ ];
335
+ }
336
+
337
+ private act(result: string | undefined, closeOnSuccess: boolean): void {
338
+ this.flash = result;
339
+ if (result === undefined && closeOnSuccess) {
340
+ this.done();
341
+ return;
342
+ }
343
+ this.tui.requestRender();
344
+ }
345
+
346
+ handleInput(data: string): void {
347
+ const rec = this.current();
348
+ this.flash = undefined;
349
+ if (matchesKey(data, Key.escape) || data === "q") {
350
+ if (this.viewId !== undefined) {
351
+ this.viewId = undefined;
352
+ this.tui.requestRender();
353
+ } else {
354
+ this.done();
355
+ }
356
+ return;
357
+ }
358
+ if (data === "f" && rec) return this.act(this.actions.foreground(rec.id), true);
359
+ if (data === "x" && rec) return this.act(this.actions.cancel(rec.id), false);
360
+ if (this.viewId === undefined) {
361
+ const n = this.ordered().length;
362
+ if (matchesKey(data, Key.up) || data === "k") this.selected = Math.max(0, this.selected - 1);
363
+ else if (matchesKey(data, Key.down) || data === "j") this.selected = Math.min(Math.max(0, n - 1), this.selected + 1);
364
+ else if ((matchesKey(data, Key.enter) || data === "\r") && rec) {
365
+ this.viewId = rec.id;
366
+ this.follow = true;
367
+ this.fullOutput = false;
368
+ }
369
+ this.tui.requestRender();
370
+ return;
371
+ }
372
+ const page = Math.max(1, (process.stdout.rows ?? 30) - 14);
373
+ if (matchesKey(data, Key.up) || data === "k") this.scrollBy(-1);
374
+ else if (matchesKey(data, Key.down) || data === "j") this.scrollBy(1);
375
+ else if (matchesKey(data, Key.pageUp)) this.scrollBy(-page);
376
+ else if (matchesKey(data, Key.pageDown) || data === " ") this.scrollBy(page);
377
+ else if (data === "g") {
378
+ this.follow = false;
379
+ this.scroll = 0;
380
+ } else if (data === "G") this.follow = true;
381
+ else if (data === "o") this.fullOutput = !this.fullOutput;
382
+ this.tui.requestRender();
383
+ }
384
+
385
+ private scrollBy(delta: number): void {
386
+ this.follow = false;
387
+ this.scroll = Math.max(0, this.scroll + delta);
388
+ }
389
+ }