@linxiraos/pi-tui 1.1.27 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (376) hide show
  1. package/CHANGELOG.md +50 -461
  2. package/README.md +7 -5
  3. package/dist/types/app-keybindings.d.ts +1 -1
  4. package/dist/types/apps/cleanse-board.d.ts +1 -1
  5. package/dist/types/apps/debug/log-viewer.d.ts +4 -0
  6. package/dist/types/apps/debug/raw-sse-buffer.d.ts +2 -0
  7. package/dist/types/apps/git/git-tui.d.ts +2 -2
  8. package/dist/types/apps/git/help.d.ts +3 -1
  9. package/dist/types/apps/if-bench-board.d.ts +2 -2
  10. package/dist/types/apps/setup-model-picker.d.ts +1 -1
  11. package/dist/types/autocomplete.d.ts +5 -2
  12. package/dist/types/charts/chart-plan.d.ts +674 -0
  13. package/dist/types/charts/chart-svg.d.ts +59 -0
  14. package/dist/types/charts/table-data.d.ts +175 -0
  15. package/dist/types/chat/assistant-message.d.ts +5 -0
  16. package/dist/types/chat/chat-transcript-builder.d.ts +2 -0
  17. package/dist/types/chat/compaction-summary-message.d.ts +1 -0
  18. package/dist/types/chat/execution-shared.d.ts +6 -5
  19. package/dist/types/chat/fence-figure.d.ts +42 -0
  20. package/dist/types/chat/figure-markdown.d.ts +42 -0
  21. package/dist/types/chat/messages.d.ts +1 -1
  22. package/dist/types/chat/svg-figure.d.ts +33 -0
  23. package/dist/types/chat/svg-source.d.ts +49 -0
  24. package/dist/types/chat/table-chart.d.ts +89 -0
  25. package/dist/types/chat/tool-execution.d.ts +2 -0
  26. package/dist/types/chat/user-message.d.ts +15 -2
  27. package/dist/types/chrome/shared.d.ts +9 -0
  28. package/dist/types/chrome/transcript-container.d.ts +6 -0
  29. package/dist/types/components/box.d.ts +1 -0
  30. package/dist/types/components/disclosure.d.ts +1 -0
  31. package/dist/types/components/editor.d.ts +15 -4
  32. package/dist/types/components/form.d.ts +1 -0
  33. package/dist/types/components/image.d.ts +12 -44
  34. package/dist/types/components/key-value-list.d.ts +1 -0
  35. package/dist/types/components/layout/row.d.ts +1 -0
  36. package/dist/types/components/layout/stack.d.ts +1 -0
  37. package/dist/types/components/markdown.d.ts +36 -3
  38. package/dist/types/components/scroll-view.d.ts +1 -0
  39. package/dist/types/components/section.d.ts +1 -0
  40. package/dist/types/components/table.d.ts +1 -0
  41. package/dist/types/components/text.d.ts +1 -0
  42. package/dist/types/components/tree-view.d.ts +7 -0
  43. package/dist/types/components/truncated-text.d.ts +1 -0
  44. package/dist/types/fuzzy.d.ts +29 -1
  45. package/dist/types/key-hint-format.d.ts +1 -1
  46. package/dist/types/keybinding-matchers.d.ts +3 -0
  47. package/dist/types/keybindings.d.ts +1 -1
  48. package/dist/types/kitty-graphics.d.ts +2 -2
  49. package/dist/types/loop-watchdog.d.ts +8 -7
  50. package/dist/types/multiplexers/cmux.d.ts +16 -0
  51. package/dist/types/multiplexers/herdr.d.ts +26 -0
  52. package/dist/types/multiplexers/notify.d.ts +13 -0
  53. package/dist/types/multiplexers/orca.d.ts +12 -0
  54. package/dist/types/multiplexers/screen.d.ts +9 -0
  55. package/dist/types/multiplexers/tmux.d.ts +29 -0
  56. package/dist/types/multiplexers/types.d.ts +100 -0
  57. package/dist/types/multiplexers/wmux.d.ts +12 -0
  58. package/dist/types/multiplexers/zellij.d.ts +12 -0
  59. package/dist/types/native/backend.d.ts +3 -2
  60. package/dist/types/native/blobs.d.ts +7 -3
  61. package/dist/types/native/encode.d.ts +3 -4
  62. package/dist/types/native/overlay.d.ts +5 -0
  63. package/dist/types/overlays/agent-hub-projection.d.ts +6 -5
  64. package/dist/types/overlays/agent-hub-types.d.ts +9 -0
  65. package/dist/types/overlays/agent-hub.d.ts +2 -0
  66. package/dist/types/overlays/agent-transcript-viewer.d.ts +11 -2
  67. package/dist/types/overlays/agents-hub.d.ts +9 -0
  68. package/dist/types/overlays/annotation-overlay.d.ts +19 -2
  69. package/dist/types/overlays/annotation-types.d.ts +2 -0
  70. package/dist/types/overlays/ask-dialog.d.ts +5 -2
  71. package/dist/types/overlays/history-search.d.ts +10 -0
  72. package/dist/types/overlays/hook-selector.d.ts +9 -4
  73. package/dist/types/overlays/jobs-panel.d.ts +1 -7
  74. package/dist/types/overlays/model-browser.d.ts +54 -7
  75. package/dist/types/overlays/model-hub.d.ts +23 -0
  76. package/dist/types/overlays/oauth-selector.d.ts +0 -1
  77. package/dist/types/overlays/plan-review-overlay.d.ts +3 -2
  78. package/dist/types/overlays/session-observer-registry.d.ts +2 -0
  79. package/dist/types/overlays/session-selector.d.ts +6 -2
  80. package/dist/types/overlays/settings-defs.d.ts +1 -0
  81. package/dist/types/overlays/usage-dashboard.d.ts +8 -4
  82. package/dist/types/overlays/usage-display.d.ts +3 -1
  83. package/dist/types/prompt/composer.d.ts +2 -7
  84. package/dist/types/prompt/custom-editor.d.ts +11 -8
  85. package/dist/types/prompt/image-source.d.ts +2 -1
  86. package/dist/types/prompt/interactive-context-helpers.d.ts +4 -1
  87. package/dist/types/prompt/model-mention-autocomplete.d.ts +1 -1
  88. package/dist/types/prompt/welcome.d.ts +19 -42
  89. package/dist/types/render/composite.d.ts +2 -0
  90. package/dist/types/render/output-pane.d.ts +1 -0
  91. package/dist/types/render/render-utils.d.ts +1 -0
  92. package/dist/types/render/tool-card.d.ts +6 -0
  93. package/dist/types/render/width-aware-text.d.ts +2 -0
  94. package/dist/types/setup/scenes/splash.d.ts +1 -1
  95. package/dist/types/setup/scenes/types.d.ts +1 -0
  96. package/dist/types/status-line/component.d.ts +3 -0
  97. package/dist/types/status-line/host.d.ts +4 -1
  98. package/dist/types/status-line/segments.d.ts +2 -0
  99. package/dist/types/status-line/types.d.ts +14 -3
  100. package/dist/types/terminal-capabilities.d.ts +27 -35
  101. package/dist/types/terminal-multiplexer.d.ts +127 -14
  102. package/dist/types/terminal.d.ts +22 -6
  103. package/dist/types/theme/active-symbols.d.ts +1 -1
  104. package/dist/types/theme/schema.d.ts +11 -2
  105. package/dist/types/theme/symbols.d.ts +1 -1
  106. package/dist/types/theme/theme-class.d.ts +7 -0
  107. package/dist/types/theme/theme.d.ts +1 -1
  108. package/dist/types/theme/tui-adapters.d.ts +3 -0
  109. package/dist/types/tmux.d.ts +11 -4
  110. package/dist/types/tools/daemon.d.ts +1 -1
  111. package/dist/types/tools/eval.d.ts +22 -3
  112. package/dist/types/tools/glob.d.ts +4 -0
  113. package/dist/types/tools/native-view.d.ts +47 -0
  114. package/dist/types/tools/output-meta.d.ts +11 -1
  115. package/dist/types/tools/renderer.d.ts +37 -2
  116. package/dist/types/tools/streaming-output.d.ts +20 -1
  117. package/dist/types/tools/task.d.ts +0 -4
  118. package/dist/types/tools/write.d.ts +9 -2
  119. package/dist/types/tools/yield.d.ts +22 -0
  120. package/dist/types/tui.d.ts +31 -0
  121. package/dist/types/utils.d.ts +6 -0
  122. package/dist/types/vim.d.ts +19 -5
  123. package/package.json +13 -9
  124. package/src/app-keybindings.d.ts +1 -1
  125. package/src/app-keybindings.ts +1 -1
  126. package/src/apps/autoresearch-dashboard.ts +7 -3
  127. package/src/apps/cleanse-board.ts +2 -2
  128. package/src/apps/cleanse-picker.ts +1 -1
  129. package/src/apps/debug/log-viewer.ts +188 -72
  130. package/src/apps/debug/raw-sse-buffer.ts +8 -0
  131. package/src/apps/debug/raw-sse.ts +39 -5
  132. package/src/apps/git/diff-pane.ts +26 -5
  133. package/src/apps/git/git-tui.ts +2 -2
  134. package/src/apps/git/help.ts +29 -20
  135. package/src/apps/if-bench-board.ts +2 -2
  136. package/src/apps/ps-top.ts +2 -2
  137. package/src/apps/setup-model-picker.ts +1 -1
  138. package/src/autocomplete.d.ts +5 -2
  139. package/src/autocomplete.ts +67 -43
  140. package/src/charts/chart-plan.d.ts +674 -0
  141. package/src/charts/chart-plan.ts +5081 -0
  142. package/src/charts/chart-svg.d.ts +59 -0
  143. package/src/charts/chart-svg.ts +4657 -0
  144. package/src/charts/table-data.d.ts +175 -0
  145. package/src/charts/table-data.ts +1478 -0
  146. package/src/chat/advisor-message.ts +11 -0
  147. package/src/chat/assistant-message.d.ts +5 -0
  148. package/src/chat/assistant-message.ts +219 -50
  149. package/src/chat/chat-transcript-builder.d.ts +2 -0
  150. package/src/chat/chat-transcript-builder.ts +5 -3
  151. package/src/chat/compaction-summary-message.d.ts +1 -0
  152. package/src/chat/compaction-summary-message.ts +8 -0
  153. package/src/chat/execution-shared.d.ts +6 -5
  154. package/src/chat/execution-shared.ts +42 -25
  155. package/src/chat/fence-figure.d.ts +42 -0
  156. package/src/chat/fence-figure.ts +80 -0
  157. package/src/chat/figure-markdown.d.ts +42 -0
  158. package/src/chat/figure-markdown.ts +174 -0
  159. package/src/chat/messages.d.ts +1 -1
  160. package/src/chat/messages.ts +1 -1
  161. package/src/chat/read-tool-group.ts +6 -4
  162. package/src/chat/skill-message.ts +6 -0
  163. package/src/chat/svg-figure.d.ts +33 -0
  164. package/src/chat/svg-figure.ts +399 -0
  165. package/src/chat/svg-source.d.ts +49 -0
  166. package/src/chat/svg-source.ts +188 -0
  167. package/src/chat/table-chart.d.ts +89 -0
  168. package/src/chat/table-chart.ts +294 -0
  169. package/src/chat/tool-execution.d.ts +2 -0
  170. package/src/chat/tool-execution.ts +80 -6
  171. package/src/chat/user-message.d.ts +15 -2
  172. package/src/chat/user-message.ts +55 -3
  173. package/src/chrome/shared.ts +53 -0
  174. package/src/chrome/transcript-container.d.ts +6 -0
  175. package/src/chrome/transcript-container.ts +93 -13
  176. package/src/components/box.d.ts +1 -0
  177. package/src/components/box.ts +5 -0
  178. package/src/components/disclosure.d.ts +1 -0
  179. package/src/components/disclosure.ts +8 -0
  180. package/src/components/editor.d.ts +15 -4
  181. package/src/components/editor.ts +294 -46
  182. package/src/components/form.d.ts +1 -0
  183. package/src/components/form.ts +8 -0
  184. package/src/components/image.d.ts +12 -44
  185. package/src/components/image.ts +47 -151
  186. package/src/components/key-value-list.d.ts +1 -0
  187. package/src/components/key-value-list.ts +4 -0
  188. package/src/components/layout/row.d.ts +1 -0
  189. package/src/components/layout/row.ts +7 -0
  190. package/src/components/layout/stack.d.ts +1 -0
  191. package/src/components/layout/stack.ts +7 -0
  192. package/src/components/markdown.d.ts +36 -3
  193. package/src/components/markdown.ts +433 -318
  194. package/src/components/scroll-view.d.ts +1 -0
  195. package/src/components/scroll-view.ts +5 -0
  196. package/src/components/section.d.ts +1 -0
  197. package/src/components/section.ts +5 -0
  198. package/src/components/settings-list.ts +2 -0
  199. package/src/components/table.d.ts +1 -0
  200. package/src/components/table.ts +4 -0
  201. package/src/components/text.d.ts +1 -0
  202. package/src/components/text.ts +7 -0
  203. package/src/components/tree-view.d.ts +7 -0
  204. package/src/components/tree-view.ts +38 -8
  205. package/src/components/truncated-text.d.ts +1 -0
  206. package/src/components/truncated-text.ts +5 -0
  207. package/src/desktop-notify.ts +1 -1
  208. package/src/fuzzy.d.ts +29 -1
  209. package/src/fuzzy.ts +115 -30
  210. package/src/key-hint-format.d.ts +1 -1
  211. package/src/key-hint-format.ts +1 -1
  212. package/src/keybinding-matchers.d.ts +3 -0
  213. package/src/keybinding-matchers.ts +6 -2
  214. package/src/keybindings.d.ts +1 -1
  215. package/src/keybindings.ts +1 -1
  216. package/src/kitty-graphics.d.ts +2 -2
  217. package/src/kitty-graphics.ts +4 -4
  218. package/src/loop-watchdog.d.ts +8 -7
  219. package/src/loop-watchdog.ts +18 -13
  220. package/src/multiplexers/cmux.d.ts +16 -0
  221. package/src/multiplexers/cmux.ts +29 -0
  222. package/src/multiplexers/herdr.d.ts +26 -0
  223. package/src/multiplexers/herdr.ts +64 -0
  224. package/src/multiplexers/notify.d.ts +13 -0
  225. package/src/multiplexers/notify.ts +24 -0
  226. package/src/multiplexers/orca.d.ts +12 -0
  227. package/src/multiplexers/orca.ts +16 -0
  228. package/src/multiplexers/screen.d.ts +9 -0
  229. package/src/multiplexers/screen.ts +15 -0
  230. package/src/multiplexers/tmux.d.ts +29 -0
  231. package/src/multiplexers/tmux.ts +40 -0
  232. package/src/multiplexers/types.d.ts +100 -0
  233. package/src/multiplexers/types.ts +110 -0
  234. package/src/multiplexers/wmux.d.ts +12 -0
  235. package/src/multiplexers/wmux.ts +16 -0
  236. package/src/multiplexers/zellij.d.ts +12 -0
  237. package/src/multiplexers/zellij.ts +24 -0
  238. package/src/native/backend.d.ts +3 -2
  239. package/src/native/backend.ts +174 -18
  240. package/src/native/blobs.d.ts +7 -3
  241. package/src/native/blobs.ts +47 -12
  242. package/src/native/encode.d.ts +3 -4
  243. package/src/native/encode.ts +58 -31
  244. package/src/native/overlay.d.ts +5 -0
  245. package/src/native/overlay.ts +13 -0
  246. package/src/native/reconcile.ts +4 -0
  247. package/src/overlays/agent-hub-projection.d.ts +6 -5
  248. package/src/overlays/agent-hub-projection.ts +124 -13
  249. package/src/overlays/agent-hub-types.d.ts +9 -0
  250. package/src/overlays/agent-hub-types.ts +6 -0
  251. package/src/overlays/agent-hub.ts +46 -31
  252. package/src/overlays/agent-transcript-viewer.ts +91 -23
  253. package/src/overlays/agents-hub.ts +28 -8
  254. package/src/overlays/annotation-overlay.ts +293 -90
  255. package/src/overlays/annotation-types.ts +2 -0
  256. package/src/overlays/ask-dialog.ts +7 -10
  257. package/src/overlays/btw-history-panel.ts +12 -1
  258. package/src/overlays/copy-selector.ts +30 -8
  259. package/src/overlays/extensions/state-manager.ts +52 -12
  260. package/src/overlays/history-search.ts +100 -7
  261. package/src/overlays/hook-selector.ts +12 -5
  262. package/src/overlays/jobs-panel.ts +28 -46
  263. package/src/overlays/model-browser.ts +341 -110
  264. package/src/overlays/model-hub.ts +300 -49
  265. package/src/overlays/move-overlay.ts +28 -14
  266. package/src/overlays/oauth-selector.ts +54 -70
  267. package/src/overlays/plan-review-overlay.ts +194 -70
  268. package/src/overlays/plugin-settings.ts +11 -5
  269. package/src/overlays/report-panel.ts +2 -2
  270. package/src/overlays/rewind-selector.ts +86 -17
  271. package/src/overlays/session-observer-registry.d.ts +2 -0
  272. package/src/overlays/session-observer-registry.ts +10 -2
  273. package/src/overlays/session-selector.ts +64 -26
  274. package/src/overlays/settings-defs.ts +4 -3
  275. package/src/overlays/settings-selector.ts +33 -8
  276. package/src/overlays/snapcompact-shape-preview.ts +2 -3
  277. package/src/overlays/stats-notice.ts +1 -1
  278. package/src/overlays/tree-selector.ts +41 -20
  279. package/src/overlays/usage-dashboard.ts +100 -50
  280. package/src/overlays/usage-display.ts +10 -4
  281. package/src/prompt/attachment-chips.ts +15 -11
  282. package/src/prompt/composer-attachments.ts +6 -4
  283. package/src/prompt/composer-cache.ts +4 -6
  284. package/src/prompt/composer.ts +6 -37
  285. package/src/prompt/custom-editor.ts +54 -26
  286. package/src/prompt/image-source.ts +2 -1
  287. package/src/prompt/interactive-context-helpers.ts +30 -18
  288. package/src/prompt/macos-spelling.ts +7 -0
  289. package/src/prompt/magic-keywords.ts +11 -2
  290. package/src/prompt/model-mention-autocomplete.ts +14 -14
  291. package/src/prompt/tips.txt +6 -5
  292. package/src/prompt/welcome.ts +235 -411
  293. package/src/prompt/word-completion.ts +38 -5
  294. package/src/render/composite.d.ts +2 -0
  295. package/src/render/composite.ts +64 -0
  296. package/src/render/output-pane.d.ts +1 -0
  297. package/src/render/output-pane.ts +6 -0
  298. package/src/render/render-utils.d.ts +1 -0
  299. package/src/render/render-utils.ts +11 -0
  300. package/src/render/tool-card.d.ts +6 -0
  301. package/src/render/tool-card.ts +15 -0
  302. package/src/render/width-aware-text.d.ts +2 -0
  303. package/src/render/width-aware-text.ts +5 -0
  304. package/src/setup/scenes/model.ts +2 -1
  305. package/src/setup/scenes/splash.ts +116 -53
  306. package/src/setup/scenes/types.ts +1 -0
  307. package/src/status-line/component.ts +292 -78
  308. package/src/status-line/host.ts +4 -1
  309. package/src/status-line/segments.ts +40 -22
  310. package/src/status-line/types.ts +15 -3
  311. package/src/terminal-capabilities.d.ts +27 -35
  312. package/src/terminal-capabilities.ts +75 -189
  313. package/src/terminal-multiplexer.d.ts +127 -14
  314. package/src/terminal-multiplexer.ts +112 -33
  315. package/src/terminal.d.ts +22 -6
  316. package/src/terminal.ts +139 -37
  317. package/src/theme/active-symbols.d.ts +1 -1
  318. package/src/theme/active-symbols.ts +1 -1
  319. package/src/theme/schema-validation.ts +1 -0
  320. package/src/theme/schema.d.ts +11 -2
  321. package/src/theme/schema.ts +14 -1
  322. package/src/theme/session-color.ts +1 -7
  323. package/src/theme/symbols.d.ts +1 -1
  324. package/src/theme/symbols.ts +6 -1
  325. package/src/theme/theme-class.d.ts +7 -0
  326. package/src/theme/theme-class.ts +26 -1
  327. package/src/theme/theme-schema.json +5 -1
  328. package/src/theme/theme.d.ts +1 -1
  329. package/src/theme/theme.ts +8 -4
  330. package/src/theme/tui-adapters.d.ts +3 -0
  331. package/src/theme/tui-adapters.ts +68 -0
  332. package/src/tmux.d.ts +11 -4
  333. package/src/tmux.ts +47 -11
  334. package/src/tools/ast-edit.ts +59 -35
  335. package/src/tools/ast-grep.ts +35 -16
  336. package/src/tools/bash.ts +92 -42
  337. package/src/tools/daemon.d.ts +1 -1
  338. package/src/tools/daemon.ts +1 -1
  339. package/src/tools/default-renderer.ts +35 -19
  340. package/src/tools/edit.ts +142 -120
  341. package/src/tools/eval-format/index.ts +28 -2
  342. package/src/tools/eval-format/javascript.ts +7 -5
  343. package/src/tools/eval.d.ts +22 -3
  344. package/src/tools/eval.ts +364 -208
  345. package/src/tools/fetch.ts +5 -6
  346. package/src/tools/glob.d.ts +4 -0
  347. package/src/tools/glob.ts +33 -65
  348. package/src/tools/grep.ts +81 -48
  349. package/src/tools/index.ts +2 -0
  350. package/src/tools/lsp.ts +81 -59
  351. package/src/tools/mcp.ts +111 -68
  352. package/src/tools/native-view.d.ts +47 -0
  353. package/src/tools/native-view.ts +102 -1
  354. package/src/tools/output-meta.d.ts +11 -1
  355. package/src/tools/output-meta.ts +23 -3
  356. package/src/tools/read.ts +7 -5
  357. package/src/tools/renderer.d.ts +37 -2
  358. package/src/tools/renderer.ts +42 -2
  359. package/src/tools/streaming-output.d.ts +20 -1
  360. package/src/tools/streaming-output.ts +149 -50
  361. package/src/tools/task.d.ts +0 -4
  362. package/src/tools/task.ts +112 -59
  363. package/src/tools/todo.ts +119 -30
  364. package/src/tools/wait.ts +34 -24
  365. package/src/tools/web-search.ts +1 -1
  366. package/src/tools/write.d.ts +9 -2
  367. package/src/tools/write.ts +147 -95
  368. package/src/tools/yield.d.ts +22 -0
  369. package/src/tools/yield.ts +225 -0
  370. package/src/tui.d.ts +31 -0
  371. package/src/tui.ts +309 -160
  372. package/src/utils.d.ts +6 -0
  373. package/src/utils.ts +19 -0
  374. package/src/vim.d.ts +19 -5
  375. package/src/vim.ts +333 -18
  376. package/src/windows-input-mode.ts +8 -0
@@ -41,15 +41,22 @@ import { sanitizeErrorLine } from "../chrome/error-block";
41
41
  import type { ScrollRangeAnchor } from "../components/scroll-view";
42
42
  import { formatContextUsage } from "../chrome/context-thresholds";
43
43
  import { node, span, text } from "../native/describe";
44
- import type { DescribeContext, NativeChild, NativeNode } from "../native/node";
45
- import { actionHint, hintsRow, overlayCard } from "../native/overlay";
44
+ import type { DescribeContext, NativeChild, NativeNode, NativeUiEvent } from "../native/node";
45
+ import { actionHint, escCloseButton, hintsRow, overlayCard } from "../native/overlay";
46
46
 
47
47
  /** Parsed message and model metadata relevant to a transcript viewer. */
48
48
  export type AgentTranscriptEntry = SessionMessageEntryLike | { type: "model_change"; model: string };
49
49
 
50
50
  /** Local filesystem and session parsing capabilities supplied by the host. */
51
51
  export interface AgentTranscriptSource {
52
- fs: Pick<typeof fs, "openSync" | "closeSync" | "readSync" | "readFileSync" | "statSync">;
52
+ /**
53
+ * Sync primitives drive the first paint and the incremental tail. When the
54
+ * host also supplies `promises.readFile` (e.g. passes `node:fs` itself), full
55
+ * reloads after rotation/rewrite read the file off the UI thread.
56
+ */
57
+ fs: Pick<typeof fs, "openSync" | "closeSync" | "readSync" | "readFileSync" | "statSync"> & {
58
+ promises?: Pick<typeof fs.promises, "readFile">;
59
+ };
53
60
  parseEntries(text: string): AgentTranscriptEntry[];
54
61
  }
55
62
 
@@ -86,6 +93,8 @@ export interface AgentTranscriptViewerDeps {
86
93
 
87
94
  /** How often to re-stat a file-backed transcript for growth (advisor/live tail). */
88
95
  const POLL_MS = 250;
96
+ /** Every Nth idle poll re-verifies sentinels, catching same-size/mtime rewrites. */
97
+ const IDLE_SENTINEL_CHECK_EVERY = 5;
89
98
 
90
99
  const SENTINEL_BYTES = 4096;
91
100
 
@@ -183,6 +192,10 @@ export class AgentTranscriptViewer implements Component {
183
192
  #model: string | undefined;
184
193
  #pollTimer: NodeJS.Timeout | undefined;
185
194
  #disposed = false;
195
+ /** Async full reload in flight; polls are skipped until it lands. */
196
+ #localLoadInFlight = false;
197
+ /** Idle polls since the sentinels were last verified. */
198
+ #idlePolls = 0;
186
199
  #initialEntryId: string | undefined;
187
200
  /** Last described node and the visible inputs it was built from. */
188
201
  #nativeCache: { signature: string; node: NativeNode } | undefined;
@@ -201,6 +214,8 @@ export class AgentTranscriptViewer implements Component {
201
214
  hideThinkingBlock: deps.hideThinkingBlock,
202
215
  proseOnlyThinking: deps.proseOnlyThinking,
203
216
  expandThinkingBlocks: deps.expandThinkingBlocks,
217
+ // Charts are for the main session's answers, not parked subagent, advisor, or guest transcripts.
218
+ tableCharts: false,
204
219
  requestRender: deps.requestRender,
205
220
  });
206
221
  this.#browser = new TranscriptBrowser({
@@ -213,8 +228,10 @@ export class AgentTranscriptViewer implements Component {
213
228
  this.#editor.setMaxHeight(4);
214
229
  this.#editor.onSubmit = text => this.#submit(text);
215
230
  }
216
- this.#refresh();
217
- this.#pollTimer = setInterval(() => this.#refresh(), POLL_MS);
231
+ // First paint loads synchronously so the initial entry can be revealed
232
+ // immediately; later full reloads from the poll may go async.
233
+ this.#refresh(false);
234
+ this.#pollTimer = setInterval(() => this.#refresh(true), POLL_MS);
218
235
  this.#pollTimer.unref?.();
219
236
  }
220
237
 
@@ -243,12 +260,13 @@ export class AgentTranscriptViewer implements Component {
243
260
  // ========================================================================
244
261
 
245
262
  /** Refresh the transcript from a local file or remote host. */
246
- #refresh(): void {
263
+ #refresh(allowAsync: boolean): void {
247
264
  if (this.#disposed) return;
248
265
  if (this.#deps.remote) {
249
266
  this.#fetchRemote();
250
267
  return;
251
268
  }
269
+ if (this.#localLoadInFlight) return;
252
270
  const sessionFile = this.#deps.registry.get(this.#deps.agentId)?.sessionFile;
253
271
  if (!sessionFile) {
254
272
  this.#clearLocal("none");
@@ -262,14 +280,29 @@ export class AgentTranscriptViewer implements Component {
262
280
  return;
263
281
  }
264
282
  const state = this.#localState;
265
- if (state && this.#canAppendLocal(sessionFile, stat, state)) {
266
- if (stat.size === state.size && stat.mtimeMs === state.mtimeMs) return;
267
- if (stat.size > state.size) {
268
- this.#appendLocal(sessionFile, stat, state);
283
+ if (state) {
284
+ // Idle fast path: an unchanged identity/size/mtime costs one stat;
285
+ // sentinels are re-read only every Nth idle poll so a rewrite that
286
+ // keeps size and mtime is still noticed.
287
+ if (
288
+ state.path === sessionFile &&
289
+ state.dev === stat.dev &&
290
+ state.ino === stat.ino &&
291
+ stat.size === state.size &&
292
+ stat.mtimeMs === state.mtimeMs
293
+ ) {
294
+ if (++this.#idlePolls < IDLE_SENTINEL_CHECK_EVERY) return;
295
+ this.#idlePolls = 0;
296
+ if (this.#canAppendLocal(sessionFile, stat, state)) return;
297
+ this.#loadLocalFull(sessionFile, stat, allowAsync);
298
+ return;
299
+ }
300
+ if (stat.size > state.size && this.#canAppendLocal(sessionFile, stat, state)) {
301
+ this.#appendLocal(sessionFile, stat, state, allowAsync);
269
302
  return;
270
303
  }
271
304
  }
272
- this.#loadLocalFull(sessionFile, stat);
305
+ this.#loadLocalFull(sessionFile, stat, allowAsync);
273
306
  }
274
307
 
275
308
  #clearLocal(reason: string): void {
@@ -303,7 +336,23 @@ export class AgentTranscriptViewer implements Component {
303
336
  return true;
304
337
  }
305
338
 
306
- #loadLocalFull(sessionFile: string, stat: fs.Stats): void {
339
+ #loadLocalFull(sessionFile: string, stat: fs.Stats, allowAsync: boolean): void {
340
+ const promises = allowAsync ? this.#deps.transcript.fs.promises : undefined;
341
+ if (promises) {
342
+ this.#localLoadInFlight = true;
343
+ void promises
344
+ .readFile(sessionFile)
345
+ .then(data => {
346
+ this.#localLoadInFlight = false;
347
+ if (!this.#disposed) this.#applyLocalFull(sessionFile, stat, data);
348
+ })
349
+ .catch((err: unknown) => {
350
+ // Leave #localState unchanged so a transient read error retries next poll.
351
+ this.#localLoadInFlight = false;
352
+ logger.debug("transcript viewer: read failed", { err: String(err) });
353
+ });
354
+ return;
355
+ }
307
356
  let data: Buffer;
308
357
  try {
309
358
  data = this.#deps.transcript.fs.readFileSync(sessionFile);
@@ -312,6 +361,10 @@ export class AgentTranscriptViewer implements Component {
312
361
  logger.debug("transcript viewer: read failed", { err: String(err) });
313
362
  return;
314
363
  }
364
+ this.#applyLocalFull(sessionFile, stat, data);
365
+ }
366
+
367
+ #applyLocalFull(sessionFile: string, stat: fs.Stats, data: Buffer): void {
315
368
  // The file may have grown between the earlier `statSync` and this read.
316
369
  // Anchor the tail cursor to what we actually consumed so the next poll's
317
370
  // `#appendLocal` never re-renders bytes already in the rebuilt transcript;
@@ -345,7 +398,7 @@ export class AgentTranscriptViewer implements Component {
345
398
  this.#rebuild(this.#extractMessages(this.#deps.transcript.parseEntries(complete)));
346
399
  }
347
400
 
348
- #appendLocal(sessionFile: string, stat: fs.Stats, state: LocalTranscriptState): void {
401
+ #appendLocal(sessionFile: string, stat: fs.Stats, state: LocalTranscriptState, allowAsync: boolean): void {
349
402
  let chunk: string;
350
403
  try {
351
404
  chunk = readFileRangeSync(
@@ -356,7 +409,7 @@ export class AgentTranscriptViewer implements Component {
356
409
  ).toString("utf-8");
357
410
  } catch (err) {
358
411
  logger.debug("transcript viewer: tail read failed", { err: String(err) });
359
- this.#loadLocalFull(sessionFile, stat);
412
+ this.#loadLocalFull(sessionFile, stat, allowAsync);
360
413
  return;
361
414
  }
362
415
  const combined = state.pending + chunk;
@@ -371,7 +424,7 @@ export class AgentTranscriptViewer implements Component {
371
424
  // File unlinked/rotated mid-poll: fall back to a guarded full reload
372
425
  // instead of letting the open escape the poll timer.
373
426
  logger.debug("transcript viewer: sentinel recompute failed", { err: String(err) });
374
- this.#loadLocalFull(sessionFile, stat);
427
+ this.#loadLocalFull(sessionFile, stat, allowAsync);
375
428
  return;
376
429
  }
377
430
  this.#localState = {
@@ -506,12 +559,7 @@ export class AgentTranscriptViewer implements Component {
506
559
  }
507
560
 
508
561
  if (matchesKey(data, "escape")) {
509
- if (this.#editor && this.#editor.getText().trim() !== "") {
510
- this.#editor.setText("");
511
- this.#deps.requestRender();
512
- return;
513
- }
514
- this.#deps.onClose();
562
+ this.#escape();
515
563
  return;
516
564
  }
517
565
 
@@ -594,6 +642,21 @@ export class AgentTranscriptViewer implements Component {
594
642
  return lines;
595
643
  }
596
644
 
645
+ /** The top-right `esc` runs Esc. */
646
+ handleNativeEvent(event: NativeUiEvent): void {
647
+ if (event.type === "action" && event.act === "close") this.#escape();
648
+ }
649
+
650
+ /** Esc: clear a non-empty draft first, else close the viewer. */
651
+ #escape(): void {
652
+ if (this.#editor && this.#editor.getText().trim() !== "") {
653
+ this.#editor.setText("");
654
+ this.#deps.requestRender();
655
+ return;
656
+ }
657
+ this.#deps.onClose();
658
+ }
659
+
597
660
  /**
598
661
  * Header, transcript body (the builder's container, which describes its own
599
662
  * blocks), notice, message editor, stats and key hints. Scrolling is the
@@ -622,6 +685,8 @@ export class AgentTranscriptViewer implements Component {
622
685
 
623
686
  const id = this.#deps.agentId;
624
687
  const children: NativeChild[] = [];
688
+ // Top row: the agent's meta on the left, a clickable `esc` (close) on the right.
689
+ const top: NativeChild[] = [];
625
690
  if (ref) {
626
691
  const kindTag = ref.parentId ? `${ref.kind} ${theme.sep.dot} of ${ref.parentId}` : ref.kind;
627
692
  const meta: NativeChild[] = [
@@ -630,8 +695,12 @@ export class AgentTranscriptViewer implements Component {
630
695
  text([span(kindTag, "dim")], { truncate: "end" }),
631
696
  ];
632
697
  if (this.#model) meta.push(text([span(this.#model, "muted")], { truncate: "end" }));
633
- children.push(node("row", { gap: "sm", align: "center" }, meta, "meta"));
698
+ top.push(node("row", { gap: "sm", align: "center", grow: 1, min: { w: 0 } }, meta, "meta"));
699
+ } else {
700
+ top.push(node("spacer", { grow: 1 }));
634
701
  }
702
+ top.push(escCloseButton());
703
+ children.push(node("row", { gap: "md", align: "center" }, top, "top"));
635
704
  children.push(
636
705
  placeholder === undefined
637
706
  ? node("col", { grow: 1 }, [this.#builder.container], "transcript")
@@ -694,7 +763,6 @@ export class AgentTranscriptViewer implements Component {
694
763
  children.push(
695
764
  hintsRow([
696
765
  this.#editor ? actionHint("tui.input.submit", "send") : undefined,
697
- { keys: ["escape"], label: "close" },
698
766
  { keys: [this.#deps.expandKeys[0] ?? "ctrl+o"], label: "expand" },
699
767
  ]),
700
768
  );
@@ -15,7 +15,7 @@ import type { TspPickerAction, TspPickerColumn, TspPickerItem, TspPickerScope, T
15
15
  import {
16
16
  type Component,
17
17
  Editor,
18
- fuzzyMatch,
18
+ FuzzyQuery,
19
19
  Input,
20
20
  matchesKey,
21
21
  replaceTabs,
@@ -141,6 +141,11 @@ export interface AgentsHubCallbacks {
141
141
  const IDENTIFIER_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+){1,5}$/;
142
142
 
143
143
  function extractJsonObject(raw: string): string {
144
+ // A bare JSON object may legitimately contain code fences inside string values; keep it intact.
145
+ try {
146
+ JSON.parse(raw);
147
+ return raw;
148
+ } catch {}
144
149
  const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)```/i);
145
150
  if (fenceMatch?.[1]) return fenceMatch[1].trim();
146
151
  const start = raw.indexOf("{");
@@ -149,7 +154,15 @@ function extractJsonObject(raw: string): string {
149
154
  return raw.trim();
150
155
  }
151
156
 
152
- function parseGeneratedAgentSpec(raw: string): GeneratedAgentSpec {
157
+ /**
158
+ * Parse model output into a {@link GeneratedAgentSpec}. Accepts a bare JSON object
159
+ * (tried first) or one wrapped in a code fence. Returns the spec with trimmed fields.
160
+ * Throws if the output is not valid JSON or not an object, if `identifier`, `whenToUse`
161
+ * or `systemPrompt` is missing or not a string, if the identifier is not lowercase
162
+ * kebab-case with 2+ words, if `whenToUse` does not start with "Use this agent when",
163
+ * or if `systemPrompt` is empty.
164
+ */
165
+ export function parseGeneratedAgentSpec(raw: string): GeneratedAgentSpec {
153
166
  const parsed = JSON.parse(extractJsonObject(raw)) as Partial<GeneratedAgentSpec>;
154
167
  if (!parsed || typeof parsed !== "object") {
155
168
  throw new Error("Model output is not a JSON object");
@@ -181,12 +194,12 @@ function listRowId(rowDef: ListRow): string {
181
194
  return rowDef.kind === "new" ? "new" : `agent:${rowDef.agent.source}:${rowDef.agent.name}`;
182
195
  }
183
196
 
184
- function matchAgent(agent: HubAgent, query: string): boolean {
197
+ /** All `tokens` (prepared once per query) fuzzy-match the agent's searchable text. */
198
+ function matchAgent(agent: HubAgent, tokens: readonly FuzzyQuery[]): boolean {
199
+ // Not memoized: `overrideModel` is edited in place, and the module index
200
+ // cache already reuses the per-text index for unchanged agents.
185
201
  const text = `${agent.name} ${agent.description} ${SOURCE_LABEL[agent.source]} ${agent.overrideModel ?? ""}`;
186
- return query
187
- .trim()
188
- .split(/\s+/)
189
- .every(token => fuzzyMatch(token, text).matches);
202
+ return tokens.every(token => token.match(text).matches);
190
203
  }
191
204
 
192
205
  /**
@@ -360,7 +373,14 @@ export class AgentsHubComponent implements Component {
360
373
  const scoped =
361
374
  entry.kind === "source" ? this.#allAgents.filter(agent => agent.source === entry.source) : this.#allAgents;
362
375
  const query = this.#search.getValue();
363
- const filtered = query ? scoped.filter(agent => matchAgent(agent, query)) : scoped;
376
+ let filtered = scoped;
377
+ if (query) {
378
+ const tokens = query
379
+ .trim()
380
+ .split(/\s+/)
381
+ .map(token => new FuzzyQuery(token));
382
+ filtered = scoped.filter(agent => matchAgent(agent, tokens));
383
+ }
364
384
  this.#rows = [...filtered.map(agent => ({ kind: "agent", agent }) as ListRow), { kind: "new" }];
365
385
  }
366
386