@linxiraos/pi-tui 1.4.4 → 1.4.7

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 (363) hide show
  1. package/CHANGELOG.md +208 -207
  2. package/README.md +34 -34
  3. package/dist/types/app-keybindings.d.ts +20 -0
  4. package/dist/types/apps/session-picker.d.ts +5 -0
  5. package/dist/types/charts/chart-plan.d.ts +9 -7
  6. package/dist/types/chat/assistant-message.d.ts +15 -3
  7. package/dist/types/chat/bash-execution.d.ts +2 -0
  8. package/dist/types/chat/display-preferences.d.ts +2 -0
  9. package/dist/types/chat/extension-types.d.ts +31 -0
  10. package/dist/types/chat/reply-write.d.ts +48 -0
  11. package/dist/types/chat/table-chart.d.ts +4 -3
  12. package/dist/types/chat/tool-execution.d.ts +1 -2
  13. package/dist/types/chat/transcript-outline.d.ts +7 -0
  14. package/dist/types/chat/transcript-render-helpers.d.ts +2 -0
  15. package/dist/types/chrome/context-map.d.ts +15 -0
  16. package/dist/types/chrome/context-presentation.d.ts +48 -0
  17. package/dist/types/chrome/context-view-model.d.ts +77 -0
  18. package/dist/types/chrome/index.d.ts +1 -0
  19. package/dist/types/chrome/transcript-notice.d.ts +35 -0
  20. package/dist/types/chrome/transcript-status.d.ts +20 -8
  21. package/dist/types/components/editor.d.ts +8 -0
  22. package/dist/types/components/image.d.ts +20 -0
  23. package/dist/types/components/loader.d.ts +1 -1
  24. package/dist/types/components/markdown.d.ts +7 -0
  25. package/dist/types/native/blobs.d.ts +11 -1
  26. package/dist/types/native/picker.d.ts +4 -4
  27. package/dist/types/overlays/advisor-config.d.ts +6 -0
  28. package/dist/types/overlays/agent-hub-projection.d.ts +3 -1
  29. package/dist/types/overlays/annotation-overlay.d.ts +7 -1
  30. package/dist/types/overlays/annotation-types.d.ts +28 -0
  31. package/dist/types/overlays/ask-dialog.d.ts +12 -3
  32. package/dist/types/overlays/btw-history-panel.d.ts +16 -2
  33. package/dist/types/overlays/btw-history.d.ts +7 -0
  34. package/dist/types/overlays/btw-panel.d.ts +2 -0
  35. package/dist/types/overlays/context-viewer-format.d.ts +42 -0
  36. package/dist/types/overlays/context-viewer-overview.d.ts +70 -0
  37. package/dist/types/overlays/context-viewer.d.ts +25 -0
  38. package/dist/types/overlays/hook-input.d.ts +1 -0
  39. package/dist/types/overlays/login-dialog.d.ts +5 -1
  40. package/dist/types/overlays/mcp-add-wizard.d.ts +2 -0
  41. package/dist/types/overlays/model-browser.d.ts +10 -1
  42. package/dist/types/overlays/oauth-selector.d.ts +23 -0
  43. package/dist/types/overlays/pause-screen.d.ts +13 -3
  44. package/dist/types/overlays/plan-review-overlay.d.ts +2 -0
  45. package/dist/types/overlays/rewind-selector.d.ts +1 -1
  46. package/dist/types/overlays/running-subagent-badge.d.ts +7 -1
  47. package/dist/types/overlays/session-selector.d.ts +22 -2
  48. package/dist/types/prompt/composer.d.ts +43 -0
  49. package/dist/types/prompt/interactive-context-helpers.d.ts +10 -3
  50. package/dist/types/prompt/macos-spelling.d.ts +2 -2
  51. package/dist/types/render/extension-links.d.ts +65 -0
  52. package/dist/types/render/hyperlink.d.ts +38 -7
  53. package/dist/types/render/index.d.ts +1 -0
  54. package/dist/types/render/output-pane.d.ts +1 -1
  55. package/dist/types/render/render-utils.d.ts +7 -1
  56. package/dist/types/setup/scenes/glyph.d.ts +1 -1
  57. package/dist/types/setup/scenes/model.d.ts +1 -1
  58. package/dist/types/setup/scenes/outro.d.ts +5 -4
  59. package/dist/types/setup/scenes/sign-in.d.ts +13 -8
  60. package/dist/types/setup/scenes/types.d.ts +16 -1
  61. package/dist/types/setup/startup-splash.d.ts +1 -1
  62. package/dist/types/setup/wizard-overlay.d.ts +11 -7
  63. package/dist/types/setup/wizard.d.ts +5 -1
  64. package/dist/types/status-line/component.d.ts +3 -3
  65. package/dist/types/status-line/context-usage.d.ts +42 -35
  66. package/dist/types/status-line/host.d.ts +6 -2
  67. package/dist/types/terminal-capabilities.d.ts +7 -0
  68. package/dist/types/theme/symbols.d.ts +1 -1
  69. package/dist/types/theme/theme.d.ts +0 -23
  70. package/dist/types/tools/ask.d.ts +4 -0
  71. package/dist/types/tools/bash-interactive.d.ts +6 -0
  72. package/dist/types/tools/bash.d.ts +2 -0
  73. package/dist/types/tools/default-renderer.d.ts +6 -4
  74. package/dist/types/tools/edit.d.ts +3 -1
  75. package/dist/types/tools/fetch.d.ts +1 -0
  76. package/dist/types/tools/github.d.ts +3 -0
  77. package/dist/types/tools/grouped-file-output.d.ts +2 -0
  78. package/dist/types/tools/irc.d.ts +6 -0
  79. package/dist/types/tools/json-tree.d.ts +23 -4
  80. package/dist/types/tools/lsp.d.ts +2 -0
  81. package/dist/types/tools/mcp.d.ts +7 -6
  82. package/dist/types/tools/native-view.d.ts +1 -1
  83. package/dist/types/tools/read.d.ts +3 -0
  84. package/dist/types/tools/renderer.d.ts +2 -0
  85. package/dist/types/tools/streaming-output.d.ts +11 -0
  86. package/dist/types/tools/task.d.ts +9 -1
  87. package/dist/types/tools/url-scheme-host.d.ts +17 -0
  88. package/dist/types/tools/wait.d.ts +16 -2
  89. package/dist/types/tools/yield.d.ts +1 -1
  90. package/dist/types/tui.d.ts +9 -2
  91. package/dist/types/vim.d.ts +39 -0
  92. package/package.json +10 -14
  93. package/src/app-keybindings.d.ts +20 -0
  94. package/src/app-keybindings.ts +20 -0
  95. package/src/apps/session-picker.ts +7 -0
  96. package/src/charts/chart-plan.d.ts +9 -7
  97. package/src/charts/chart-plan.ts +20 -50
  98. package/src/chat/advisor-message.ts +2 -0
  99. package/src/chat/assistant-message.d.ts +15 -3
  100. package/src/chat/assistant-message.ts +137 -19
  101. package/src/chat/background-tan-message.ts +4 -0
  102. package/src/chat/bash-execution.d.ts +2 -0
  103. package/src/chat/bash-execution.ts +13 -1
  104. package/src/chat/chat-transcript-builder.ts +58 -28
  105. package/src/chat/compaction-summary-message.ts +2 -1
  106. package/src/chat/display-preferences.d.ts +2 -0
  107. package/src/chat/display-preferences.ts +3 -0
  108. package/src/chat/extension-types.d.ts +31 -0
  109. package/src/chat/extension-types.ts +34 -0
  110. package/src/chat/read-tool-group.ts +1 -2
  111. package/src/chat/reply-write.d.ts +48 -0
  112. package/src/chat/reply-write.ts +127 -0
  113. package/src/chat/skill-message.ts +2 -6
  114. package/src/chat/table-chart.d.ts +4 -3
  115. package/src/chat/table-chart.ts +10 -4
  116. package/src/chat/tool-execution.d.ts +1 -2
  117. package/src/chat/tool-execution.ts +20 -13
  118. package/src/chat/transcript-outline.d.ts +7 -0
  119. package/src/chat/transcript-outline.ts +27 -0
  120. package/src/chat/transcript-render-helpers.d.ts +2 -0
  121. package/src/chat/transcript-render-helpers.ts +66 -24
  122. package/src/chrome/context-map.ts +62 -0
  123. package/src/chrome/context-presentation.ts +26 -0
  124. package/src/chrome/context-view-model.ts +73 -0
  125. package/src/chrome/index.ts +1 -0
  126. package/src/chrome/transcript-container.ts +89 -59
  127. package/src/chrome/transcript-notice.d.ts +35 -0
  128. package/src/chrome/transcript-notice.ts +83 -0
  129. package/src/chrome/transcript-status.d.ts +20 -8
  130. package/src/chrome/transcript-status.ts +29 -29
  131. package/src/components/editor.d.ts +8 -0
  132. package/src/components/editor.ts +465 -14
  133. package/src/components/image.d.ts +20 -0
  134. package/src/components/image.ts +83 -18
  135. package/src/components/loader.d.ts +1 -1
  136. package/src/components/loader.ts +1 -1
  137. package/src/components/markdown.d.ts +7 -0
  138. package/src/components/markdown.ts +225 -13
  139. package/src/hotkeys-markdown.ts +2 -0
  140. package/src/native/backend.ts +5 -66
  141. package/src/native/blobs.d.ts +11 -1
  142. package/src/native/blobs.ts +5 -3
  143. package/src/native/picker.d.ts +4 -4
  144. package/src/native/picker.ts +4 -4
  145. package/src/overlays/advisor-config.ts +10 -12
  146. package/src/overlays/agent-hub-projection.d.ts +3 -1
  147. package/src/overlays/agent-hub-projection.ts +6 -5
  148. package/src/overlays/agent-hub.ts +51 -42
  149. package/src/overlays/annotation-overlay.ts +125 -37
  150. package/src/overlays/annotation-types.ts +24 -0
  151. package/src/overlays/ask-dialog.ts +125 -35
  152. package/src/overlays/btw-history-panel.ts +124 -12
  153. package/src/overlays/btw-history.ts +11 -0
  154. package/src/overlays/btw-panel.ts +8 -4
  155. package/src/overlays/context-viewer-format.ts +145 -0
  156. package/src/overlays/context-viewer-overview.ts +381 -0
  157. package/src/overlays/context-viewer.ts +728 -0
  158. package/src/overlays/hook-input.ts +2 -0
  159. package/src/overlays/hook-selector.ts +2 -2
  160. package/src/overlays/login-dialog.ts +31 -5
  161. package/src/overlays/mcp-add-wizard.ts +6 -1
  162. package/src/overlays/model-browser.ts +37 -0
  163. package/src/overlays/model-hub.ts +1 -7
  164. package/src/overlays/model-picker.ts +1 -10
  165. package/src/overlays/oauth-selector.ts +44 -6
  166. package/src/overlays/pause-screen.ts +166 -33
  167. package/src/overlays/plan-review-overlay.ts +13 -2
  168. package/src/overlays/rewind-selector.ts +29 -12
  169. package/src/overlays/running-subagent-badge.ts +12 -1
  170. package/src/overlays/session-selector.ts +313 -42
  171. package/src/overlays/settings-defs.ts +1 -0
  172. package/src/overlays/usage-dashboard.ts +20 -14
  173. package/src/prompt/composer.ts +216 -1
  174. package/src/prompt/custom-editor.ts +6 -1
  175. package/src/prompt/emoji-autocomplete.ts +0 -2
  176. package/src/prompt/interactive-context-helpers.ts +29 -4
  177. package/src/prompt/macos-spelling.ts +24 -15
  178. package/src/render/extension-links.d.ts +65 -0
  179. package/src/render/extension-links.ts +214 -0
  180. package/src/render/hyperlink.d.ts +38 -7
  181. package/src/render/hyperlink.ts +102 -23
  182. package/src/render/index.d.ts +1 -0
  183. package/src/render/index.ts +1 -0
  184. package/src/render/output-pane.d.ts +1 -1
  185. package/src/render/output-pane.ts +60 -17
  186. package/src/render/render-utils.d.ts +7 -1
  187. package/src/render/render-utils.ts +11 -2
  188. package/src/setup/scenes/composer.ts +2 -0
  189. package/src/setup/scenes/glyph.ts +3 -1
  190. package/src/setup/scenes/model.ts +192 -29
  191. package/src/setup/scenes/outro.ts +33 -15
  192. package/src/setup/scenes/sign-in.ts +194 -392
  193. package/src/setup/scenes/theme.ts +2 -0
  194. package/src/setup/scenes/types.ts +18 -1
  195. package/src/setup/startup-splash.ts +8 -7
  196. package/src/setup/wizard-overlay.ts +164 -35
  197. package/src/setup/wizard.ts +11 -2
  198. package/src/status-line/component.ts +10 -14
  199. package/src/status-line/context-usage.ts +122 -597
  200. package/src/status-line/host.ts +6 -2
  201. package/src/terminal-capabilities.d.ts +7 -0
  202. package/src/terminal-capabilities.ts +10 -0
  203. package/src/terminal.ts +24 -2
  204. package/src/theme/defaults.json +1 -0
  205. package/src/theme/loader.ts +1 -1
  206. package/src/theme/symbols.d.ts +1 -1
  207. package/src/theme/symbols.ts +16 -0
  208. package/src/theme/theme.d.ts +0 -23
  209. package/src/theme/theme.ts +2 -75
  210. package/src/tools/ask.d.ts +4 -0
  211. package/src/tools/ask.ts +4 -0
  212. package/src/tools/ast-grep.ts +3 -2
  213. package/src/tools/bash-interactive.d.ts +49 -0
  214. package/src/tools/bash-interactive.ts +6 -1
  215. package/src/tools/bash.d.ts +2 -0
  216. package/src/tools/bash.ts +7 -23
  217. package/src/tools/default-renderer.d.ts +6 -4
  218. package/src/tools/default-renderer.ts +9 -6
  219. package/src/tools/edit.d.ts +3 -1
  220. package/src/tools/edit.ts +8 -4
  221. package/src/tools/eval.ts +14 -4
  222. package/src/tools/fetch.d.ts +1 -0
  223. package/src/tools/fetch.ts +1 -0
  224. package/src/tools/find.ts +3 -10
  225. package/src/tools/github.d.ts +3 -0
  226. package/src/tools/github.ts +23 -3
  227. package/src/tools/glob.ts +4 -3
  228. package/src/tools/grep.ts +3 -4
  229. package/src/tools/grouped-file-output.d.ts +2 -0
  230. package/src/tools/grouped-file-output.ts +8 -2
  231. package/src/tools/irc.d.ts +6 -0
  232. package/src/tools/irc.ts +6 -0
  233. package/src/tools/job-widget.ts +13 -1
  234. package/src/tools/json-tree.d.ts +23 -4
  235. package/src/tools/json-tree.ts +132 -42
  236. package/src/tools/lsp.d.ts +2 -0
  237. package/src/tools/lsp.ts +36 -15
  238. package/src/tools/mcp.d.ts +7 -6
  239. package/src/tools/mcp.ts +41 -15
  240. package/src/tools/native-view.d.ts +1 -1
  241. package/src/tools/native-view.ts +3 -3
  242. package/src/tools/read.d.ts +3 -0
  243. package/src/tools/read.ts +3 -1
  244. package/src/tools/renderer.d.ts +2 -0
  245. package/src/tools/renderer.ts +2 -0
  246. package/src/tools/streaming-output.d.ts +11 -0
  247. package/src/tools/streaming-output.ts +41 -0
  248. package/src/tools/task.d.ts +9 -1
  249. package/src/tools/task.ts +59 -16
  250. package/src/tools/url-scheme-host.d.ts +17 -0
  251. package/src/tools/url-scheme-host.ts +21 -0
  252. package/src/tools/vibe.ts +14 -3
  253. package/src/tools/wait.d.ts +16 -2
  254. package/src/tools/wait.ts +16 -2
  255. package/src/tools/yield.d.ts +1 -1
  256. package/src/tools/yield.ts +18 -9
  257. package/src/tui.d.ts +9 -2
  258. package/src/tui.ts +102 -34
  259. package/src/vim.d.ts +39 -0
  260. package/src/vim.ts +313 -22
  261. package/dist/types/theme/defaults/index.d.ts +0 -10289
  262. package/src/theme/defaults/alabaster.json +0 -103
  263. package/src/theme/defaults/amethyst.json +0 -106
  264. package/src/theme/defaults/anthracite.json +0 -103
  265. package/src/theme/defaults/basalt.json +0 -101
  266. package/src/theme/defaults/birch.json +0 -105
  267. package/src/theme/defaults/dark-abyss.json +0 -101
  268. package/src/theme/defaults/dark-arctic.json +0 -114
  269. package/src/theme/defaults/dark-aurora.json +0 -105
  270. package/src/theme/defaults/dark-catppuccin.json +0 -117
  271. package/src/theme/defaults/dark-cavern.json +0 -101
  272. package/src/theme/defaults/dark-celestial.json +0 -116
  273. package/src/theme/defaults/dark-copper.json +0 -105
  274. package/src/theme/defaults/dark-cosmos.json +0 -100
  275. package/src/theme/defaults/dark-cyberpunk.json +0 -112
  276. package/src/theme/defaults/dark-dracula.json +0 -108
  277. package/src/theme/defaults/dark-eclipse.json +0 -101
  278. package/src/theme/defaults/dark-ember.json +0 -105
  279. package/src/theme/defaults/dark-equinox.json +0 -100
  280. package/src/theme/defaults/dark-forest.json +0 -106
  281. package/src/theme/defaults/dark-github.json +0 -115
  282. package/src/theme/defaults/dark-gruvbox.json +0 -122
  283. package/src/theme/defaults/dark-lavender.json +0 -105
  284. package/src/theme/defaults/dark-lunar.json +0 -99
  285. package/src/theme/defaults/dark-midnight.json +0 -105
  286. package/src/theme/defaults/dark-monochrome.json +0 -104
  287. package/src/theme/defaults/dark-monokai.json +0 -108
  288. package/src/theme/defaults/dark-nebula.json +0 -100
  289. package/src/theme/defaults/dark-neon-noir.json +0 -110
  290. package/src/theme/defaults/dark-nord.json +0 -108
  291. package/src/theme/defaults/dark-ocean.json +0 -111
  292. package/src/theme/defaults/dark-one.json +0 -110
  293. package/src/theme/defaults/dark-poimandres.json +0 -125
  294. package/src/theme/defaults/dark-rainforest.json +0 -101
  295. package/src/theme/defaults/dark-reef.json +0 -101
  296. package/src/theme/defaults/dark-retro.json +0 -102
  297. package/src/theme/defaults/dark-rose-pine.json +0 -106
  298. package/src/theme/defaults/dark-sakura.json +0 -105
  299. package/src/theme/defaults/dark-slate.json +0 -105
  300. package/src/theme/defaults/dark-solarized.json +0 -107
  301. package/src/theme/defaults/dark-solstice.json +0 -100
  302. package/src/theme/defaults/dark-starfall.json +0 -101
  303. package/src/theme/defaults/dark-sunset.json +0 -109
  304. package/src/theme/defaults/dark-swamp.json +0 -100
  305. package/src/theme/defaults/dark-synthwave.json +0 -113
  306. package/src/theme/defaults/dark-taiga.json +0 -101
  307. package/src/theme/defaults/dark-terminal.json +0 -105
  308. package/src/theme/defaults/dark-tokyo-night.json +0 -111
  309. package/src/theme/defaults/dark-tundra.json +0 -101
  310. package/src/theme/defaults/dark-twilight.json +0 -101
  311. package/src/theme/defaults/dark-volcanic.json +0 -101
  312. package/src/theme/defaults/graphite.json +0 -102
  313. package/src/theme/defaults/index.d.ts +0 -10289
  314. package/src/theme/defaults/index.ts +0 -203
  315. package/src/theme/defaults/light-arctic.json +0 -117
  316. package/src/theme/defaults/light-aurora-day.json +0 -101
  317. package/src/theme/defaults/light-canyon.json +0 -101
  318. package/src/theme/defaults/light-catppuccin.json +0 -116
  319. package/src/theme/defaults/light-cirrus.json +0 -100
  320. package/src/theme/defaults/light-coral.json +0 -105
  321. package/src/theme/defaults/light-cyberpunk.json +0 -106
  322. package/src/theme/defaults/light-dawn.json +0 -100
  323. package/src/theme/defaults/light-dunes.json +0 -101
  324. package/src/theme/defaults/light-eucalyptus.json +0 -105
  325. package/src/theme/defaults/light-forest.json +0 -110
  326. package/src/theme/defaults/light-frost.json +0 -105
  327. package/src/theme/defaults/light-github.json +0 -125
  328. package/src/theme/defaults/light-glacier.json +0 -101
  329. package/src/theme/defaults/light-gruvbox.json +0 -118
  330. package/src/theme/defaults/light-haze.json +0 -100
  331. package/src/theme/defaults/light-honeycomb.json +0 -105
  332. package/src/theme/defaults/light-lagoon.json +0 -101
  333. package/src/theme/defaults/light-lavender.json +0 -105
  334. package/src/theme/defaults/light-meadow.json +0 -101
  335. package/src/theme/defaults/light-mint.json +0 -105
  336. package/src/theme/defaults/light-monochrome.json +0 -111
  337. package/src/theme/defaults/light-ocean.json +0 -109
  338. package/src/theme/defaults/light-one.json +0 -109
  339. package/src/theme/defaults/light-opal.json +0 -101
  340. package/src/theme/defaults/light-orchard.json +0 -101
  341. package/src/theme/defaults/light-paper.json +0 -105
  342. package/src/theme/defaults/light-poimandres.json +0 -125
  343. package/src/theme/defaults/light-prism.json +0 -100
  344. package/src/theme/defaults/light-retro.json +0 -108
  345. package/src/theme/defaults/light-sand.json +0 -105
  346. package/src/theme/defaults/light-savanna.json +0 -101
  347. package/src/theme/defaults/light-solarized.json +0 -112
  348. package/src/theme/defaults/light-soleil.json +0 -100
  349. package/src/theme/defaults/light-sunset.json +0 -109
  350. package/src/theme/defaults/light-synthwave.json +0 -108
  351. package/src/theme/defaults/light-tokyo-night.json +0 -121
  352. package/src/theme/defaults/light-wetland.json +0 -101
  353. package/src/theme/defaults/light-zenith.json +0 -99
  354. package/src/theme/defaults/limestone.json +0 -104
  355. package/src/theme/defaults/mahogany.json +0 -107
  356. package/src/theme/defaults/marble.json +0 -103
  357. package/src/theme/defaults/obsidian.json +0 -101
  358. package/src/theme/defaults/onyx.json +0 -101
  359. package/src/theme/defaults/pearl.json +0 -103
  360. package/src/theme/defaults/porcelain.json +0 -101
  361. package/src/theme/defaults/quartz.json +0 -106
  362. package/src/theme/defaults/sandstone.json +0 -105
  363. package/src/theme/defaults/titanium.json +0 -100
package/README.md CHANGED
@@ -28,7 +28,7 @@ const tui = new TUI(terminal);
28
28
  tui.addChild(new Text("Welcome to my app!"));
29
29
 
30
30
  const editor = new Editor(editorTheme);
31
- editor.onSubmit = (text) => {
31
+ editor.onSubmit = text => {
32
32
  console.log("Submitted:", text);
33
33
  tui.addChild(new Text(`You said: ${text}`));
34
34
  };
@@ -106,12 +106,12 @@ interface Component {
106
106
  }
107
107
  ```
108
108
 
109
- | Method | Description |
110
- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
109
+ | Method | Description |
110
+ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
111
111
  | `render(width)` | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
112
- | `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences). |
113
- | `invalidate?()` | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call. |
114
- | `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
112
+ | `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences). |
113
+ | `invalidate?()` | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call. |
114
+ | `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
115
115
 
116
116
  ## Built-in Components
117
117
 
@@ -119,20 +119,20 @@ interface Component {
119
119
 
120
120
  Build screens from persistent components and update their data, selection, expansion, or size through setters. Layouts own child bounds and mouse-coordinate translation; controllers retain domain workflows and asynchronous operations. Propagate `invalidate()` after theme changes and `dispose()` when removing an owned component tree.
121
121
 
122
- | Family | Components | Import |
123
- | --- | --- | --- |
124
- | Layout | `Stack`, `Row`, `SplitPane` | package root |
125
- | Panels | `OverlayPanel`, `PanelRows`, `PanelDivider` | `/chrome` |
126
- | Menus | `SelectList`, `MenuSelection` | package root |
127
- | Forms | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField` | package root |
128
- | Wizard steps | `WizardStep` | package root |
129
- | Viewports | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
130
- | Trees | `TreeView` | package root |
131
- | Disclosure | `Disclosure`, with lazy summary/detail children | package root |
132
- | Messages | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent` | `/chrome` |
133
- | Tool output | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane` | `/render` |
134
- | Transcripts | `TranscriptBrowser` | package root |
135
- | Data | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section` | package root |
122
+ | Family | Components | Import |
123
+ | ------------ | ------------------------------------------------------------------------------- | ------------ |
124
+ | Layout | `Stack`, `Row`, `SplitPane` | package root |
125
+ | Panels | `OverlayPanel`, `PanelRows`, `PanelDivider` | `/chrome` |
126
+ | Menus | `SelectList`, `MenuSelection` | package root |
127
+ | Forms | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField` | package root |
128
+ | Wizard steps | `WizardStep` | package root |
129
+ | Viewports | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
130
+ | Trees | `TreeView` | package root |
131
+ | Disclosure | `Disclosure`, with lazy summary/detail children | package root |
132
+ | Messages | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent` | `/chrome` |
133
+ | Tool output | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane` | `/render` |
134
+ | Transcripts | `TranscriptBrowser` | package root |
135
+ | Data | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section` | package root |
136
136
 
137
137
  ```typescript
138
138
  import { Disclosure, SplitPane, Text } from "@linxiraos/pi-tui";
@@ -176,10 +176,10 @@ Container that applies padding and background color to all children.
176
176
  const box = new Box(
177
177
  1, // paddingX (default: 1)
178
178
  1, // paddingY (default: 1)
179
- (text) => chalk.bgGray(text), // optional background function
179
+ text => chalk.bgGray(text), // optional background function
180
180
  );
181
181
  box.addChild(new Text("Content"));
182
- box.setBgFn((text) => chalk.bgBlue(text)); // Change background dynamically
182
+ box.setBgFn(text => chalk.bgBlue(text)); // Change background dynamically
183
183
  ```
184
184
 
185
185
  ### Text
@@ -191,10 +191,10 @@ const text = new Text(
191
191
  "Hello World", // text content
192
192
  1, // paddingX (default: 1)
193
193
  1, // paddingY (default: 1)
194
- (text) => chalk.bgGray(text), // optional background function
194
+ text => chalk.bgGray(text), // optional background function
195
195
  );
196
196
  text.setText("Updated text");
197
- text.setCustomBgFn((text) => chalk.bgBlue(text));
197
+ text.setCustomBgFn(text => chalk.bgBlue(text));
198
198
  ```
199
199
 
200
200
  ### TruncatedText
@@ -215,7 +215,7 @@ Single-line text input with horizontal scrolling.
215
215
 
216
216
  ```typescript
217
217
  const input = new Input();
218
- input.onSubmit = (value) => console.log(value);
218
+ input.onSubmit = value => console.log(value);
219
219
  input.setValue("initial");
220
220
  input.getValue();
221
221
  ```
@@ -285,11 +285,11 @@ interface EditorTheme {
285
285
  }
286
286
 
287
287
  const editor = new Editor(theme);
288
- editor.onSubmit = (text) => console.log(text);
289
- editor.onChange = (text) => console.log("Changed:", text);
288
+ editor.onSubmit = text => console.log(text);
289
+ editor.onChange = text => console.log("Changed:", text);
290
290
  editor.disableSubmit = true; // Disable submit temporarily
291
291
  editor.setAutocompleteProvider(provider);
292
- editor.borderColor = (s) => chalk.blue(s); // Change border dynamically
292
+ editor.borderColor = s => chalk.blue(s); // Change border dynamically
293
293
  ```
294
294
 
295
295
  **Features:**
@@ -371,8 +371,8 @@ Animated loading spinner.
371
371
  ```typescript
372
372
  const loader = new Loader(
373
373
  tui, // TUI instance for render updates
374
- (s) => chalk.cyan(s), // spinner color function
375
- (s) => chalk.gray(s), // message color function
374
+ s => chalk.cyan(s), // spinner color function
375
+ s => chalk.gray(s), // message color function
376
376
  "Loading...", // message (default: "Loading...")
377
377
  );
378
378
  loader.start();
@@ -387,8 +387,8 @@ Extends Loader with Escape key handling and an AbortSignal for cancelling async
387
387
  ```typescript
388
388
  const loader = new CancellableLoader(
389
389
  tui, // TUI instance for render updates
390
- (s) => chalk.cyan(s), // spinner color function
391
- (s) => chalk.gray(s), // message color function
390
+ s => chalk.cyan(s), // spinner color function
391
+ s => chalk.gray(s), // message color function
392
392
  "Working...", // message
393
393
  );
394
394
  loader.onAbort = () => done(null); // Called when user presses Escape
@@ -430,9 +430,9 @@ const list = new SelectList(
430
430
  theme, // SelectListTheme
431
431
  );
432
432
 
433
- list.onSelect = (item) => console.log("Selected:", item);
433
+ list.onSelect = item => console.log("Selected:", item);
434
434
  list.onCancel = () => console.log("Cancelled");
435
- list.onSelectionChange = (item) => console.log("Highlighted:", item);
435
+ list.onSelectionChange = item => console.log("Highlighted:", item);
436
436
  list.setFilter("opt"); // Filter items
437
437
  ```
438
438
 
@@ -20,6 +20,7 @@ interface AppKeybindings {
20
20
  "app.ask.hide": true;
21
21
  "app.approval.approve": true;
22
22
  "app.editor.external": true;
23
+ "app.local.open": true;
23
24
  "app.message.followUp": true;
24
25
  "app.retry": true;
25
26
  "app.message.dequeue": true;
@@ -38,10 +39,13 @@ interface AppKeybindings {
38
39
  "app.session.rename": true;
39
40
  "app.session.delete": true;
40
41
  "app.session.deleteNoninvasive": true;
42
+ "app.session.pin": true;
43
+ "app.session.unpin": true;
41
44
  "app.tree.previousBranch": true;
42
45
  "app.tree.nextBranch": true;
43
46
  "app.plan.toggle": true;
44
47
  "app.history.search": true;
48
+ "app.links.hint": true;
45
49
  "app.stt.pushToTalk": true;
46
50
  "app.stt.toggle": true;
47
51
  "app.live.toggle": true;
@@ -252,6 +256,10 @@ export declare const KEYBINDINGS: {
252
256
  readonly defaultKeys: "ctrl+g";
253
257
  readonly description: "Open external editor";
254
258
  };
259
+ readonly "app.local.open": {
260
+ readonly defaultKeys: "alt+g";
261
+ readonly description: "Open a local:// file in external editor";
262
+ };
255
263
  readonly "app.message.followUp": {
256
264
  readonly defaultKeys: ["ctrl+q", "ctrl+enter"];
257
265
  readonly description: "Send follow-up message";
@@ -324,6 +332,14 @@ export declare const KEYBINDINGS: {
324
332
  readonly defaultKeys: "ctrl+backspace";
325
333
  readonly description: "Delete session (non-invasive)";
326
334
  };
335
+ readonly "app.session.pin": {
336
+ readonly defaultKeys: "alt+k";
337
+ readonly description: "Pin the selected session in the resume picker";
338
+ };
339
+ readonly "app.session.unpin": {
340
+ readonly defaultKeys: "alt+shift+k";
341
+ readonly description: "Unpin the selected session in the resume picker";
342
+ };
327
343
  readonly "app.tree.previousBranch": {
328
344
  readonly defaultKeys: [];
329
345
  readonly description: "Jump to the previous branch in /tree";
@@ -340,6 +356,10 @@ export declare const KEYBINDINGS: {
340
356
  readonly defaultKeys: "ctrl+r";
341
357
  readonly description: "Search history";
342
358
  };
359
+ readonly "app.links.hint": {
360
+ readonly defaultKeys: "alt+o";
361
+ readonly description: "Pick an extension link on screen by its hint tag";
362
+ };
343
363
  readonly "app.stt.pushToTalk": {
344
364
  readonly defaultKeys: "space";
345
365
  readonly description: "Hold to record speech-to-text";
@@ -5,6 +5,9 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
5
5
  loadPinnedIds?(): Promise<ReadonlySet<string>>;
6
6
  loadHistoryMatcher?(): SessionHistoryMatcher;
7
7
  deleteSession?(session: T): Promise<boolean>;
8
+ /** Rename the session and resolve with the title as stored, or null when it did not happen. */
9
+ renameSession?(session: T, title: string): Promise<string | null>;
10
+ setSessionPinned?(session: T, pinned: boolean): Promise<void>;
8
11
  loadAllSessions?(): Promise<T[]>;
9
12
  /** Builds the three-level resume source for the standalone `--resume` tree. */
10
13
  loadResumeSource?(deleteMode: "trash" | "permanent", workspacePath?: string): Promise<ResumeTreeSource | undefined>;
@@ -16,6 +19,8 @@ export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSe
16
19
  scopeLabel?: string | false;
17
20
  showCwd?: boolean;
18
21
  allowDelete?: boolean;
22
+ /** Rename the selected session; resolve with the title as stored, or null when it did not happen. */
23
+ onRename?: (session: T, title: string) => Promise<string | null>;
19
24
  allowGlobalScope?: boolean;
20
25
  historySearch?: boolean;
21
26
  pinnedIds?: ReadonlySet<string>;
@@ -419,9 +419,10 @@ export type ChartAnnotation = {
419
419
  export declare function planChart(table: TableAnalysis): ChartPlan | undefined;
420
420
  /**
421
421
  * Whether a model should pick `table`'s chart (`tui.autoGraph: smart`):
422
- * multi-series tables, and tables whose rows may be named by a number the
423
- * `guess` plots (`Thread | State`, `Finding | Current`), where only meaning
424
- * tells a name from a measure.
422
+ * multi-series tables, tables whose rows may be named by a number the
423
+ * `guess` plots (`Thread | State`, `Finding | Current`), and any other chart
424
+ * the guess would draw — only meaning tells a measure from page references,
425
+ * step numbers or figures quoted in prose, which the judge charts as none.
425
426
  */
426
427
  export declare function shouldJudge(table: TableAnalysis, guess: ChartPlan | undefined): boolean;
427
428
  /** Measure columns before `guess`'s text label column: numbers that may only name their rows. */
@@ -446,10 +447,11 @@ export declare function tableTakeaways(table: TableAnalysis, plan: ChartPlan, co
446
447
  */
447
448
  export declare function drawnNames(spec: ChartSpec): Set<string>;
448
449
  /**
449
- * The local guess at what `plan`'s rows and measures mean: header keywords
450
- * for each measure's {@link Polarity} (resources like tokens or memory only
451
- * beside a baseline), rivals from the label's header, focus from bolded or
452
- * `(current)` row names, and a status column whose cells vary.
450
+ * The local guess at what `plan`'s rows and measures mean: each measure's
451
+ * {@link Polarity} as far as its unit says ({@link dimPolarity}; what a name
452
+ * means — `Memory` as a capacity or a cost — is the judge's call), rivals from
453
+ * the label's header, focus from bolded or `(current)` row names, and a status
454
+ * column whose cells vary.
453
455
  */
454
456
  export declare function guessMeaning(table: TableAnalysis, plan: ChartPlan): Pick<ChartPlan, "polarity" | "rowPolarity" | "rivals" | "focus" | "status">;
455
457
  /** Whether `plan`'s rows may each be a metric of their own: a `change`, a transposed table, or mixed-unit columns. */
@@ -1,7 +1,7 @@
1
1
  import type { AssistantMessage, ImageContent } from "@linxiraos/pi-ai";
2
2
  import { type Component, Container } from "../tui.js";
3
3
  import { type ImageBudget } from "../components/image.js";
4
- import type { AssistantThinkingRenderer } from "./extension-types.js";
4
+ import type { AssistantTextRenderer, AssistantTextRendering, AssistantThinkingRenderer } from "./extension-types.js";
5
5
  import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
6
6
  import { type CacheInvalidation } from "./cache-invalidation-marker.js";
7
7
  import { type ServedModelMismatch } from "./served-model-marker.js";
@@ -38,7 +38,7 @@ export declare class AssistantMessageComponent extends Container {
38
38
  * for lack of a target is re-rendered with its reaction stripped.
39
39
  */
40
40
  pickReactionTarget(transcript: readonly Component[]): void;
41
- constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean);
41
+ constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean, textRendering?: AssistantTextRendering);
42
42
  /**
43
43
  * Show or clear the trailing cache-invalidation divider. Set at `message_end`
44
44
  * (live) or during rebuild, once the turn's usage is known and compared
@@ -87,7 +87,7 @@ export declare class AssistantMessageComponent extends Container {
87
87
  */
88
88
  setExpanded(expanded: boolean): void;
89
89
  isTranscriptBlockFinalized(): boolean;
90
- /** Whether a figure still waits for the raster of its final source; the transcript holds retirement meanwhile. */
90
+ /** Hold image and figure rendering until the completed block can enter immutable scrollback. */
91
91
  isTranscriptBlockPending(): boolean;
92
92
  render(width: number): readonly string[];
93
93
  /**
@@ -122,7 +122,19 @@ export declare class AssistantMessageComponent extends Container {
122
122
  renderTranscriptBlockEmergencyRow(width: number): string | undefined;
123
123
  getTranscriptBlockVersion(): number;
124
124
  markTranscriptBlockFinalized(): void;
125
+ /**
126
+ * Swap the extension text renderers (the setting enabling them changed) and redraw with them.
127
+ * Enabling them also drops rows already published as stable, since a renderer may rewrite them;
128
+ * callers MUST pair this with a scrollback-clearing display reset, as for
129
+ * {@link resetTranscriptStableRows}.
130
+ */
131
+ setTextRenderers(renderers: readonly AssistantTextRenderer[]): void;
125
132
  applyRetryRecovery(retryRecovery: AssistantMessage["retryRecovery"]): void;
133
+ /**
134
+ * Draw the current message again when it is the reply sent at `timestamp`, re-running the
135
+ * extension text renderers; returns whether it was. The caller schedules the frame.
136
+ */
137
+ rerenderMessage(timestamp: number): boolean;
126
138
  messagePersistenceKey(): string | undefined;
127
139
  /** Toggle rendering for assistant-native and tool-result images. */
128
140
  setImagesVisible(visible: boolean): void;
@@ -37,6 +37,8 @@ export declare class BashExecutionComponent extends Container {
37
37
  appendOutput(chunk: string): void;
38
38
  /** Switch to PTY rendering and feed raw terminal bytes through the vterm replay. */
39
39
  appendPtyChunk(chunk: string): void;
40
+ /** Bytes a terminal would send for a key event, honoring the command's cursor-key mode; "" for key releases. */
41
+ encodePtyInput(data: string): string;
40
42
  setComplete(exitCode: number | undefined, cancelled: boolean, options?: {
41
43
  output?: string;
42
44
  truncation?: TruncationMeta;
@@ -6,6 +6,8 @@ export interface ChatTranscriptDisplayPreferences {
6
6
  cacheMissMarker: boolean;
7
7
  showTokenUsage: boolean;
8
8
  showTurnTime: boolean;
9
+ /** Max rows a collapsed advisor card shows below its header; 0 = no cap. */
10
+ advisorCollapsedLines: number;
9
11
  }
10
12
  /** Current transcript display preferences. */
11
13
  export declare const chatTranscriptDisplayPreferences: ChatTranscriptDisplayPreferences;
@@ -1,3 +1,4 @@
1
+ import type { AssistantMessage } from "@linxiraos/pi-ai";
1
2
  import type { Component, TUI } from "../tui.js";
2
3
  import type { Theme } from "../theme/theme.js";
3
4
  import type { CustomMessage, HookMessage } from "./messages.js";
@@ -17,6 +18,36 @@ export interface AssistantThinkingRenderContext {
17
18
  requestRender(): void;
18
19
  }
19
20
  export type AssistantThinkingRenderer = (context: AssistantThinkingRenderContext, theme: Theme) => Component | undefined;
21
+ export interface AssistantTextRenderContext {
22
+ /**
23
+ * The message being drawn; `message.timestamp` identifies the reply for `ctx.ui.rerenderMessage()`.
24
+ * After a tool call this is only the segment drawn there, so its `content` does not hold the whole reply.
25
+ * A deep copy: editing it, at any depth, cannot change the stored reply.
26
+ */
27
+ message: AssistantMessage;
28
+ /**
29
+ * The text block's index in the full reply's `content`, also when the reply is drawn in segments
30
+ * around tool calls; not an index into `message.content` for a segment. It counts the content as
31
+ * currently stored: a transcript rebuild that drops tool calls left without a result shifts later
32
+ * blocks down, so do not persist it as a permanent key.
33
+ */
34
+ contentIndex: number;
35
+ /** The block's markdown as drawn so far, after any earlier renderer. */
36
+ text: string;
37
+ /** True while the block may still grow; false for its final render, a block sealed at a tool call, and later redraws. */
38
+ streaming: boolean;
39
+ }
40
+ /**
41
+ * Display-only transform of one assistant text block: returns the markdown to draw, or `undefined`
42
+ * to draw `context.text` unchanged. The session, exports and model context keep the original text.
43
+ */
44
+ export type AssistantTextRenderer = (context: AssistantTextRenderContext) => string | undefined;
45
+ /** Extension text renderers for one assistant component, and where its content starts in the full reply. */
46
+ export interface AssistantTextRendering {
47
+ renderers: readonly AssistantTextRenderer[];
48
+ /** Index in the full reply's `content` of this component's first block; a segment after a tool call starts past it. */
49
+ contentOffset: number;
50
+ }
20
51
  export interface HookMessageRenderOptions {
21
52
  /** Whether the view is expanded */
22
53
  expanded: boolean;
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Replies: text the agent sends to a scheme whose writes are `reply`-scoped (`out://`)
3
+ * is its mid-turn message to the user, drawn as assistant prose so it can answer
4
+ * without ending its turn.
5
+ * - A `write` call to a reply URL draws as {@link ReplyWriteComponent}, streaming as the
6
+ * call's arguments arrive, instead of a tool card.
7
+ * - Text a tool's commands write there (`printf … > out://` in bash) arrives in the
8
+ * tool's result `details.replies` ({@link toolResultReplies}); transcripts draw each
9
+ * one as a prose block after the call ({@link replyDisplayMessage}).
10
+ */
11
+ import type { AssistantMessage } from "@linxiraos/pi-ai";
12
+ import type { ImageBudget } from "../components/image.js";
13
+ import { AssistantMessageComponent } from "./assistant-message.js";
14
+ import type { ToolExecutionHandle, ToolResultFrame } from "./tool-execution.js";
15
+ /**
16
+ * Whether a `toolName` call writes to a reply URL. `undefined` while streamed args cannot tell yet:
17
+ * no path so far, or a path that could still grow into a reply URL (`ou`, `out:/`). Callers holding
18
+ * final args treat `undefined` as `false`.
19
+ */
20
+ export declare function isReplyWrite(toolName: string, args: unknown): boolean | undefined;
21
+ /** Display options of a reply block; the rest of its presentation follows the assistant prose defaults. */
22
+ export interface ReplyWriteOptions {
23
+ /** Repaint request for figures and images that finish loading after a render. */
24
+ readonly requestRender?: () => void;
25
+ readonly imageBudget?: ImageBudget;
26
+ /** Resolved local destinations of Markdown links, as for assistant text. */
27
+ readonly linkTargets?: ReadonlyMap<string, string>;
28
+ }
29
+ /** Replies a tool result carries in `details.replies` (text its commands wrote to a reply URL), oldest first. */
30
+ export declare function toolResultReplies(details: unknown): readonly string[];
31
+ /** Assistant message drawing reply text. No provider turn backs it, so its identity fields stay empty. */
32
+ export declare function replyDisplayMessage(text: string, errorMessage?: string): AssistantMessage;
33
+ /**
34
+ * A reply write ({@link isReplyWrite}) drawn as assistant prose. The call's lifecycle arrives
35
+ * through {@link ToolExecutionHandle}: streamed args grow the text, final args settle it, and
36
+ * the result seals the block, a failure showing its error under the text. It is a reply, not
37
+ * tool activity, so hiding tool activity leaves it on screen.
38
+ */
39
+ export declare class ReplyWriteComponent extends AssistantMessageComponent implements ToolExecutionHandle {
40
+ #private;
41
+ constructor(options?: ReplyWriteOptions);
42
+ updateArgs(args: unknown): void;
43
+ setArgsComplete(): void;
44
+ setExecutionStarted(): void;
45
+ updateResult(result: ToolResultFrame, isPartial?: boolean): void;
46
+ parkAsBackground(): void;
47
+ seal(): void;
48
+ }
@@ -19,10 +19,11 @@ export interface TableChartRequest {
19
19
  readonly guess: ChartPlan;
20
20
  }
21
21
  /**
22
- * Picks the chart for a multi-series table under `smart`: a plan, or `null`
23
- * for no chart. A rejection falls back to the local guess.
22
+ * Picks the chart for a table under `smart`: a plan, or `null` for no chart.
23
+ * A rejection falls back to the local guess; `undefined` (no judge to ask
24
+ * right now) keeps the guess at once, exactly as `always` would draw it.
24
25
  */
25
- export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null>;
26
+ export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null> | undefined;
26
27
  /**
27
28
  * The chart under a table: its SVG, colored with figure tokens (`var(--accent)`, …)
28
29
  * still to resolve; none; or a smart pick on its way (the promise settles once the cache holds it).
@@ -35,7 +35,6 @@ export interface ToolExecutionHandle extends Component {
35
35
  setArgsComplete(toolCallId?: string): void;
36
36
  setExecutionStarted(toolCallId?: string): void;
37
37
  setExpanded(expanded: boolean): void;
38
- setToolActivityVisible(visible: boolean): void;
39
38
  /** Mark the call parked: it returned, but stays tracked for async job frames. */
40
39
  parkAsBackground(): void;
41
40
  /** Seal the block as final history and stop its animations. */
@@ -102,7 +101,7 @@ export declare class ToolExecutionComponent extends Container {
102
101
  * component-scoped so the TUI reuses every other root subtree (issue #4377).
103
102
  */
104
103
  tickSpinner(frame: number): void;
105
- /** Whether the result's figure still waits for its raster; the transcript holds retirement meanwhile. */
104
+ /** Hold visible results until their figures and Kitty images are ready for immutable scrollback. */
106
105
  isTranscriptBlockPending(): boolean;
107
106
  /**
108
107
  * Whether this block is ready to retire as immutable history. Partial
@@ -9,6 +9,7 @@ import { type TranscriptEntryLike as TranscriptEntry } from "./transcript-entry.
9
9
  import type { SessionMessageEntryLike as SessionMessageEntry } from "./transcript-entry.js";
10
10
  import { type ThemeColor } from "../theme/index.js";
11
11
  import type { ChatTranscriptBuilder } from "./chat-transcript-builder.js";
12
+ import type { DescribeContext } from "../native/node.js";
12
13
  /** One selectable transcript item: a message entry plus its rendered block range. */
13
14
  export interface OutlineTarget {
14
15
  /** Entry the selection resolves to; extended over trailing componentless tool results. */
@@ -63,6 +64,12 @@ export declare class OutlineRowCache {
63
64
  export declare function appendOutlineEntries(builder: ChatTranscriptBuilder, entries: TranscriptEntry[]): OutlineTarget[];
64
65
  /** Per-target "renders at least one non-blank row" flags at the given rows. */
65
66
  export declare function outlineVisibility(childRows: readonly (readonly string[])[], targets: readonly OutlineTarget[]): boolean[];
67
+ /**
68
+ * Per-target "describes something that shows" flags: {@link outlineVisibility}
69
+ * for a TSP page, where blocks describe nodes instead of rendering rows. An
70
+ * empty `col`/`row` (an interrupted turn with no output) shows nothing.
71
+ */
72
+ export declare function describedVisibility(blocks: readonly Component[], targets: readonly OutlineTarget[], cx: DescribeContext): boolean[];
66
73
  /** Dotted horizontal rule with rounded corners, spanning the outline width. */
67
74
  export declare function outlineRule(left: string, right: string, innerWidth: number, color?: ThemeColor, caption?: string): string;
68
75
  /** Wrap pre-rendered rows in the dotted outline (rules above/below, `┆` sides). */
@@ -55,6 +55,8 @@ export declare function assistantHasVisibleContent(message: AssistantAgentMessag
55
55
  export declare function splitAssistantMessageToolTimeline(message: AssistantAgentMessage): {
56
56
  beforeTools: AssistantAgentMessage;
57
57
  afterToolCalls: ReadonlyMap<string, AssistantAgentMessage>;
58
+ /** Index in `message.content` of each after-tool segment's first block, by tool-call id. */
59
+ contentOffsets: ReadonlyMap<string, number>;
58
60
  hasToolCalls: boolean;
59
61
  lastToolCallId?: string;
60
62
  };
@@ -0,0 +1,15 @@
1
+ /** Pure occupancy calculations for contiguous token segments, independent of themes and renderers. */
2
+ export interface ContextMapSegment<T> {
3
+ readonly id: T;
4
+ readonly tokens: number;
5
+ }
6
+ export interface ContextMapCell<T> {
7
+ readonly id: T;
8
+ readonly full: boolean;
9
+ }
10
+ /**
11
+ * Lays `segments` out in order over a `columns` × `rows` grid representing `windowTokens`; each cell takes the
12
+ * segment covering most of it and is `full` at 70% coverage or more. Returns `[]` when the window or grid
13
+ * size is unusable, and omits cells no segment touches.
14
+ */
15
+ export declare function planContextMap<T>(segments: readonly ContextMapSegment<T>[], windowTokens: number, columns: number, rows: number): ContextMapCell<T>[];
@@ -0,0 +1,48 @@
1
+ import type { ContextCategoryId } from "./context-view-model.js";
2
+ export declare const CONTEXT_PRESENTATION: {
3
+ readonly "system-prompt": {
4
+ readonly color: "accent";
5
+ readonly symbol: "context.content";
6
+ };
7
+ readonly skills: {
8
+ readonly color: "success";
9
+ readonly symbol: "context.content";
10
+ };
11
+ readonly "built-in-tools": {
12
+ readonly color: "warning";
13
+ readonly symbol: "context.content";
14
+ };
15
+ readonly "custom-tools": {
16
+ readonly color: "customMessageLabel";
17
+ readonly symbol: "context.content";
18
+ };
19
+ readonly "user-messages": {
20
+ readonly color: "accent";
21
+ readonly symbol: "context.messages";
22
+ };
23
+ readonly "assistant-messages": {
24
+ readonly color: "userMessageText";
25
+ readonly symbol: "context.messages";
26
+ };
27
+ readonly "assistant-thinking": {
28
+ readonly color: "customMessageLabel";
29
+ readonly symbol: "context.content";
30
+ };
31
+ readonly "tool-calls": {
32
+ readonly color: "warning";
33
+ readonly symbol: "context.content";
34
+ };
35
+ readonly "tool-output": {
36
+ readonly color: "muted";
37
+ readonly symbol: "context.messages";
38
+ };
39
+ readonly buffer: {
40
+ readonly color: "warning";
41
+ readonly symbol: "context.buffer";
42
+ };
43
+ readonly free: {
44
+ readonly color: "dim";
45
+ readonly symbol: "context.free";
46
+ };
47
+ };
48
+ export type ContextPresentationId = ContextCategoryId | "buffer" | "free";
@@ -0,0 +1,77 @@
1
+ /** Context snapshot shapes shared by the session snapshot builder and the context viewer. */
2
+ import type { ContextBreakdown } from "../status-line/context-usage.js";
3
+ interface ContextCategoryDescriptor {
4
+ readonly id: string;
5
+ readonly label: string;
6
+ /** Overview row label when the Overview weight differs from the category's content. */
7
+ readonly overviewLabel?: string;
8
+ /** Listed with its weight but never opened. */
9
+ readonly openable?: false;
10
+ }
11
+ /** Context categories in display order. */
12
+ export declare const CONTEXT_CATEGORIES: readonly [{
13
+ readonly id: "system-prompt";
14
+ readonly label: "System Prompt";
15
+ readonly overviewLabel: "System Prompt (excluding Skills)";
16
+ }, {
17
+ readonly id: "skills";
18
+ readonly label: "Skills";
19
+ readonly openable: false;
20
+ }, {
21
+ readonly id: "built-in-tools";
22
+ readonly label: "Built-in Tools";
23
+ }, {
24
+ readonly id: "custom-tools";
25
+ readonly label: "Custom Tools";
26
+ }, {
27
+ readonly id: "user-messages";
28
+ readonly label: "User / Developer Messages";
29
+ }, {
30
+ readonly id: "assistant-messages";
31
+ readonly label: "Assistant Messages";
32
+ }, {
33
+ readonly id: "assistant-thinking";
34
+ readonly label: "Assistant Thinking";
35
+ }, {
36
+ readonly id: "tool-calls";
37
+ readonly label: "Tool Calls";
38
+ }, {
39
+ readonly id: "tool-output";
40
+ readonly label: "Tool Output";
41
+ }];
42
+ export type ContextCategoryId = (typeof CONTEXT_CATEGORIES)[number]["id"];
43
+ /** Descriptor of a category id: its label, optional Overview label, and whether it can be opened. */
44
+ export declare function contextCategoryDescriptor(id: ContextCategoryId): ContextCategoryDescriptor;
45
+ export interface ContextThinkingGroup {
46
+ readonly id: string;
47
+ readonly label: string;
48
+ readonly tokens: number;
49
+ readonly interrupted?: boolean;
50
+ }
51
+ export interface ContextViewEntry {
52
+ readonly id: string;
53
+ readonly label: string;
54
+ readonly text: string;
55
+ /** Aggregation weight for the unscaled replay estimate; shared blocks contribute through their group. */
56
+ readonly tokens: number;
57
+ readonly interrupted?: boolean;
58
+ readonly thinkingGroup?: ContextThinkingGroup;
59
+ readonly path?: string;
60
+ readonly info?: string;
61
+ readonly timestamp?: number;
62
+ readonly callId?: string;
63
+ }
64
+ export interface ContextViewCategory {
65
+ id: ContextCategoryId;
66
+ key?: string;
67
+ label: string;
68
+ /** Overview attribution weight, not reported usage; may differ from the entry sum (e.g. Skills subtraction). */
69
+ tokens: number;
70
+ entries: ContextViewEntry[];
71
+ children?: ContextViewCategory[];
72
+ }
73
+ export interface ContextViewData {
74
+ readonly breakdown: ContextBreakdown;
75
+ readonly categories: readonly ContextViewCategory[];
76
+ }
77
+ export {};
@@ -16,5 +16,6 @@ export * from "./shared.js";
16
16
  export * from "./streaming-panel.js";
17
17
  export * from "./tool-activity.js";
18
18
  export * from "./transcript-container.js";
19
+ export * from "./transcript-notice.js";
19
20
  export * from "./transcript-status.js";
20
21
  export * from "./visual-truncate.js";