@linxiraos/pi-tui 1.4.6 → 1.4.9

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 (399) hide show
  1. package/CHANGELOG.md +162 -244
  2. package/README.md +41 -35
  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/charts/table-data.d.ts +4 -2
  7. package/dist/types/chat/assistant-message.d.ts +15 -3
  8. package/dist/types/chat/bash-execution.d.ts +6 -1
  9. package/dist/types/chat/display-preferences.d.ts +2 -0
  10. package/dist/types/chat/eval-execution.d.ts +2 -0
  11. package/dist/types/chat/execution-shared.d.ts +14 -8
  12. package/dist/types/chat/extension-types.d.ts +31 -0
  13. package/dist/types/chat/figure-markdown.d.ts +2 -0
  14. package/dist/types/chat/reply-write.d.ts +48 -0
  15. package/dist/types/chat/svg-figure.d.ts +5 -0
  16. package/dist/types/chat/table-chart.d.ts +6 -3
  17. package/dist/types/chat/tool-execution.d.ts +1 -2
  18. package/dist/types/chat/transcript-outline.d.ts +7 -0
  19. package/dist/types/chat/transcript-render-helpers.d.ts +13 -3
  20. package/dist/types/chrome/dynamic-border.d.ts +6 -0
  21. package/dist/types/chrome/index.d.ts +1 -0
  22. package/dist/types/chrome/transcript-notice.d.ts +35 -0
  23. package/dist/types/chrome/transcript-status.d.ts +21 -9
  24. package/dist/types/components/editor.d.ts +23 -6
  25. package/dist/types/components/image.d.ts +6 -0
  26. package/dist/types/components/loader.d.ts +2 -0
  27. package/dist/types/components/markdown.d.ts +7 -0
  28. package/dist/types/keybinding-matchers.d.ts +7 -0
  29. package/dist/types/native/blobs.d.ts +2 -1
  30. package/dist/types/native/describe.d.ts +4 -2
  31. package/dist/types/native/node.d.ts +2 -3
  32. package/dist/types/native/overlay.d.ts +42 -2
  33. package/dist/types/native/picker.d.ts +4 -4
  34. package/dist/types/native/state.d.ts +4 -0
  35. package/dist/types/overlays/annotation-overlay.d.ts +7 -1
  36. package/dist/types/overlays/annotation-types.d.ts +28 -0
  37. package/dist/types/overlays/btw-history-panel.d.ts +15 -0
  38. package/dist/types/overlays/btw-history.d.ts +24 -0
  39. package/dist/types/overlays/btw-inject.d.ts +22 -0
  40. package/dist/types/overlays/btw-panel.d.ts +7 -0
  41. package/dist/types/overlays/hook-editor.d.ts +2 -0
  42. package/dist/types/overlays/jobs-panel.d.ts +4 -0
  43. package/dist/types/overlays/login-dialog.d.ts +5 -1
  44. package/dist/types/overlays/model-browser.d.ts +11 -2
  45. package/dist/types/overlays/oauth-selector.d.ts +23 -0
  46. package/dist/types/overlays/plan-review-overlay.d.ts +2 -0
  47. package/dist/types/overlays/rewind-selector.d.ts +1 -1
  48. package/dist/types/overlays/session-selector.d.ts +33 -4
  49. package/dist/types/prompt/composer.d.ts +56 -5
  50. package/dist/types/prompt/interactive-context-helpers.d.ts +10 -3
  51. package/dist/types/render/extension-links.d.ts +65 -0
  52. package/dist/types/render/hyperlink.d.ts +25 -7
  53. package/dist/types/render/index.d.ts +1 -0
  54. package/dist/types/render/render-utils.d.ts +23 -1
  55. package/dist/types/setup/scenes/glyph.d.ts +1 -1
  56. package/dist/types/setup/scenes/model.d.ts +1 -1
  57. package/dist/types/setup/scenes/outro.d.ts +5 -4
  58. package/dist/types/setup/scenes/sign-in.d.ts +13 -8
  59. package/dist/types/setup/scenes/types.d.ts +16 -1
  60. package/dist/types/setup/startup-splash.d.ts +1 -1
  61. package/dist/types/setup/wizard-overlay.d.ts +11 -7
  62. package/dist/types/setup/wizard.d.ts +5 -1
  63. package/dist/types/status-line/component.d.ts +1 -1
  64. package/dist/types/status-line/context-usage.d.ts +28 -6
  65. package/dist/types/status-line/host.d.ts +6 -2
  66. package/dist/types/status-line/startup.d.ts +0 -15
  67. package/dist/types/terminal-capabilities.d.ts +1 -1
  68. package/dist/types/theme/symbols.d.ts +3 -1
  69. package/dist/types/theme/theme-class.d.ts +1 -0
  70. package/dist/types/theme/theme.d.ts +1 -24
  71. package/dist/types/theme/tui-adapters.d.ts +2 -0
  72. package/dist/types/thinking.d.ts +8 -6
  73. package/dist/types/tools/ast-grep.d.ts +2 -0
  74. package/dist/types/tools/bash-interactive.d.ts +6 -0
  75. package/dist/types/tools/bash.d.ts +2 -0
  76. package/dist/types/tools/default-renderer.d.ts +6 -4
  77. package/dist/types/tools/eval.d.ts +2 -0
  78. package/dist/types/tools/find.d.ts +1 -1
  79. package/dist/types/tools/grouped-file-output.d.ts +100 -19
  80. package/dist/types/tools/hashline-format.d.ts +5 -0
  81. package/dist/types/tools/irc.d.ts +6 -0
  82. package/dist/types/tools/json-tree.d.ts +23 -4
  83. package/dist/types/tools/lsp.d.ts +2 -0
  84. package/dist/types/tools/mcp.d.ts +6 -5
  85. package/dist/types/tools/native-view.d.ts +3 -1
  86. package/dist/types/tools/output-meta.d.ts +27 -0
  87. package/dist/types/tools/read.d.ts +14 -4
  88. package/dist/types/tools/renderer.d.ts +2 -0
  89. package/dist/types/tools/streaming-output.d.ts +11 -0
  90. package/dist/types/tools/task.d.ts +13 -4
  91. package/dist/types/tools/url-scheme-host.d.ts +17 -0
  92. package/dist/types/tools/wait.d.ts +2 -0
  93. package/dist/types/tools/yield.d.ts +1 -1
  94. package/dist/types/tui.d.ts +19 -2
  95. package/dist/types/utils.d.ts +4 -0
  96. package/package.json +10 -14
  97. package/src/app-keybindings.d.ts +20 -0
  98. package/src/app-keybindings.ts +20 -0
  99. package/src/apps/git/git-tui.ts +10 -17
  100. package/src/apps/git/sidebar.ts +21 -35
  101. package/src/apps/ps-top.ts +4 -12
  102. package/src/apps/session-picker.ts +7 -0
  103. package/src/charts/chart-plan.d.ts +9 -7
  104. package/src/charts/chart-plan.ts +20 -79
  105. package/src/charts/table-data.d.ts +4 -2
  106. package/src/charts/table-data.ts +55 -6
  107. package/src/chat/advisor-message.ts +2 -0
  108. package/src/chat/assistant-message.d.ts +15 -3
  109. package/src/chat/assistant-message.ts +137 -19
  110. package/src/chat/background-tan-message.ts +4 -0
  111. package/src/chat/bash-execution.d.ts +6 -1
  112. package/src/chat/bash-execution.ts +26 -9
  113. package/src/chat/chat-transcript-builder.ts +63 -30
  114. package/src/chat/compaction-summary-message.ts +2 -1
  115. package/src/chat/display-preferences.d.ts +2 -0
  116. package/src/chat/display-preferences.ts +3 -0
  117. package/src/chat/eval-execution.d.ts +2 -0
  118. package/src/chat/eval-execution.ts +14 -7
  119. package/src/chat/execution-shared.d.ts +14 -8
  120. package/src/chat/execution-shared.ts +39 -18
  121. package/src/chat/extension-types.d.ts +31 -0
  122. package/src/chat/extension-types.ts +34 -0
  123. package/src/chat/figure-markdown.d.ts +2 -0
  124. package/src/chat/figure-markdown.ts +6 -4
  125. package/src/chat/read-tool-group.ts +56 -36
  126. package/src/chat/reply-write.d.ts +48 -0
  127. package/src/chat/reply-write.ts +127 -0
  128. package/src/chat/svg-figure.d.ts +5 -0
  129. package/src/chat/svg-figure.ts +55 -16
  130. package/src/chat/table-chart.d.ts +6 -3
  131. package/src/chat/table-chart.ts +29 -6
  132. package/src/chat/tool-execution.d.ts +1 -2
  133. package/src/chat/tool-execution.ts +20 -13
  134. package/src/chat/transcript-outline.d.ts +7 -0
  135. package/src/chat/transcript-outline.ts +27 -0
  136. package/src/chat/transcript-render-helpers.d.ts +13 -3
  137. package/src/chat/transcript-render-helpers.ts +134 -44
  138. package/src/chrome/dynamic-border.d.ts +6 -0
  139. package/src/chrome/dynamic-border.ts +28 -2
  140. package/src/chrome/index.ts +1 -0
  141. package/src/chrome/transcript-notice.d.ts +35 -0
  142. package/src/chrome/transcript-notice.ts +83 -0
  143. package/src/chrome/transcript-status.d.ts +21 -9
  144. package/src/chrome/transcript-status.ts +32 -30
  145. package/src/components/editor.d.ts +23 -6
  146. package/src/components/editor.ts +133 -25
  147. package/src/components/image.d.ts +6 -0
  148. package/src/components/image.ts +13 -0
  149. package/src/components/key-value-list.ts +9 -9
  150. package/src/components/loader.d.ts +2 -0
  151. package/src/components/loader.ts +7 -0
  152. package/src/components/markdown.d.ts +7 -0
  153. package/src/components/markdown.ts +116 -6
  154. package/src/components/section.ts +1 -9
  155. package/src/components/table.ts +1 -9
  156. package/src/hotkeys-markdown.ts +1 -0
  157. package/src/keybinding-matchers.d.ts +7 -0
  158. package/src/keybinding-matchers.ts +13 -0
  159. package/src/native/backend.ts +10 -67
  160. package/src/native/blobs.d.ts +2 -1
  161. package/src/native/blobs.ts +3 -2
  162. package/src/native/describe.d.ts +4 -2
  163. package/src/native/describe.ts +9 -4
  164. package/src/native/node.d.ts +2 -3
  165. package/src/native/node.ts +2 -3
  166. package/src/native/overlay.d.ts +42 -2
  167. package/src/native/overlay.ts +124 -16
  168. package/src/native/picker.d.ts +4 -4
  169. package/src/native/picker.ts +4 -4
  170. package/src/native/state.d.ts +4 -0
  171. package/src/native/state.ts +25 -5
  172. package/src/overlays/advisor-config.ts +1 -10
  173. package/src/overlays/annotation-overlay.ts +125 -37
  174. package/src/overlays/annotation-types.ts +24 -0
  175. package/src/overlays/btw-history-panel.ts +106 -14
  176. package/src/overlays/btw-history.ts +65 -0
  177. package/src/overlays/btw-inject.ts +91 -0
  178. package/src/overlays/btw-panel.ts +53 -12
  179. package/src/overlays/extensions/extension-dashboard.ts +7 -8
  180. package/src/overlays/hook-editor.ts +6 -0
  181. package/src/overlays/hook-selector.ts +2 -2
  182. package/src/overlays/jobs-panel.ts +82 -22
  183. package/src/overlays/login-dialog.ts +39 -31
  184. package/src/overlays/mcp-add-wizard.ts +1 -1
  185. package/src/overlays/model-browser.ts +106 -10
  186. package/src/overlays/model-hub.ts +1 -7
  187. package/src/overlays/model-picker.ts +1 -10
  188. package/src/overlays/oauth-selector.ts +44 -6
  189. package/src/overlays/plan-review-overlay.ts +13 -2
  190. package/src/overlays/rewind-selector.ts +29 -12
  191. package/src/overlays/session-selector.ts +338 -47
  192. package/src/overlays/settings-defs.ts +2 -2
  193. package/src/overlays/tree-selector.ts +83 -27
  194. package/src/overlays/usage-dashboard.ts +9 -18
  195. package/src/prompt/composer.ts +233 -6
  196. package/src/prompt/custom-editor.ts +6 -1
  197. package/src/prompt/emoji-autocomplete.ts +0 -2
  198. package/src/prompt/interactive-context-helpers.ts +29 -4
  199. package/src/render/code-cell.ts +1 -1
  200. package/src/render/extension-links.d.ts +65 -0
  201. package/src/render/extension-links.ts +214 -0
  202. package/src/render/file-list.ts +4 -7
  203. package/src/render/hyperlink.d.ts +25 -7
  204. package/src/render/hyperlink.ts +65 -9
  205. package/src/render/index.d.ts +1 -0
  206. package/src/render/index.ts +1 -0
  207. package/src/render/render-utils.d.ts +23 -1
  208. package/src/render/render-utils.ts +38 -6
  209. package/src/setup/scenes/composer.ts +2 -0
  210. package/src/setup/scenes/glyph.ts +4 -2
  211. package/src/setup/scenes/model.ts +192 -29
  212. package/src/setup/scenes/outro.ts +33 -15
  213. package/src/setup/scenes/sign-in.ts +196 -400
  214. package/src/setup/scenes/theme.ts +2 -0
  215. package/src/setup/scenes/types.ts +18 -1
  216. package/src/setup/startup-splash.ts +8 -7
  217. package/src/setup/wizard-overlay.ts +164 -35
  218. package/src/setup/wizard.ts +11 -2
  219. package/src/status-line/component.ts +4 -10
  220. package/src/status-line/context-usage.ts +72 -21
  221. package/src/status-line/host.ts +6 -2
  222. package/src/status-line/startup.ts +36 -70
  223. package/src/terminal-capabilities.d.ts +1 -1
  224. package/src/terminal-capabilities.ts +5 -0
  225. package/src/terminal.ts +24 -2
  226. package/src/theme/defaults.json +1 -0
  227. package/src/theme/loader.ts +1 -1
  228. package/src/theme/symbols.d.ts +3 -1
  229. package/src/theme/symbols.ts +16 -9
  230. package/src/theme/theme-class.d.ts +1 -0
  231. package/src/theme/theme-class.ts +15 -3
  232. package/src/theme/theme.d.ts +1 -24
  233. package/src/theme/theme.ts +3 -75
  234. package/src/theme/tui-adapters.d.ts +2 -0
  235. package/src/theme/tui-adapters.ts +8 -3
  236. package/src/thinking.d.ts +8 -6
  237. package/src/thinking.ts +17 -11
  238. package/src/tmux.ts +1 -0
  239. package/src/tools/agent-tree.ts +13 -11
  240. package/src/tools/ask.ts +24 -37
  241. package/src/tools/ast-edit.ts +48 -93
  242. package/src/tools/ast-grep.d.ts +2 -0
  243. package/src/tools/ast-grep.ts +31 -67
  244. package/src/tools/bash-interactive.d.ts +49 -0
  245. package/src/tools/bash-interactive.ts +6 -1
  246. package/src/tools/bash.d.ts +2 -0
  247. package/src/tools/bash.ts +9 -0
  248. package/src/tools/default-renderer.d.ts +6 -4
  249. package/src/tools/default-renderer.ts +10 -7
  250. package/src/tools/edit.ts +50 -43
  251. package/src/tools/eval.d.ts +2 -0
  252. package/src/tools/eval.ts +16 -4
  253. package/src/tools/fetch.ts +2 -1
  254. package/src/tools/find.d.ts +1 -1
  255. package/src/tools/find.ts +13 -5
  256. package/src/tools/github.ts +14 -46
  257. package/src/tools/glob.ts +2 -1
  258. package/src/tools/grep.ts +47 -277
  259. package/src/tools/grouped-file-output.d.ts +100 -19
  260. package/src/tools/grouped-file-output.ts +414 -103
  261. package/src/tools/hashline-format.d.ts +5 -0
  262. package/src/tools/hashline-format.ts +5 -0
  263. package/src/tools/irc.d.ts +6 -0
  264. package/src/tools/irc.ts +6 -0
  265. package/src/tools/job-widget.ts +13 -1
  266. package/src/tools/json-tree.d.ts +23 -4
  267. package/src/tools/json-tree.ts +132 -46
  268. package/src/tools/lsp.d.ts +2 -0
  269. package/src/tools/lsp.ts +246 -47
  270. package/src/tools/mcp.d.ts +6 -5
  271. package/src/tools/mcp.ts +20 -12
  272. package/src/tools/native-view.d.ts +3 -1
  273. package/src/tools/native-view.ts +12 -6
  274. package/src/tools/output-meta.d.ts +27 -0
  275. package/src/tools/output-meta.ts +68 -4
  276. package/src/tools/proc-render.ts +3 -3
  277. package/src/tools/read.d.ts +14 -4
  278. package/src/tools/read.ts +20 -5
  279. package/src/tools/renderer.d.ts +2 -0
  280. package/src/tools/renderer.ts +2 -0
  281. package/src/tools/streaming-output.d.ts +11 -0
  282. package/src/tools/streaming-output.ts +41 -0
  283. package/src/tools/task.d.ts +13 -4
  284. package/src/tools/task.ts +100 -97
  285. package/src/tools/url-scheme-host.d.ts +17 -0
  286. package/src/tools/url-scheme-host.ts +21 -0
  287. package/src/tools/vibe.ts +4 -4
  288. package/src/tools/wait.d.ts +2 -0
  289. package/src/tools/wait.ts +8 -5
  290. package/src/tools/write.ts +17 -27
  291. package/src/tools/yield.d.ts +1 -1
  292. package/src/tools/yield.ts +19 -10
  293. package/src/tui.d.ts +19 -2
  294. package/src/tui.ts +134 -24
  295. package/src/utils.d.ts +4 -0
  296. package/src/utils.ts +10 -0
  297. package/dist/types/theme/defaults/index.d.ts +0 -10289
  298. package/src/theme/defaults/alabaster.json +0 -103
  299. package/src/theme/defaults/amethyst.json +0 -106
  300. package/src/theme/defaults/anthracite.json +0 -103
  301. package/src/theme/defaults/basalt.json +0 -101
  302. package/src/theme/defaults/birch.json +0 -105
  303. package/src/theme/defaults/dark-abyss.json +0 -101
  304. package/src/theme/defaults/dark-arctic.json +0 -114
  305. package/src/theme/defaults/dark-aurora.json +0 -105
  306. package/src/theme/defaults/dark-catppuccin.json +0 -117
  307. package/src/theme/defaults/dark-cavern.json +0 -101
  308. package/src/theme/defaults/dark-celestial.json +0 -116
  309. package/src/theme/defaults/dark-copper.json +0 -105
  310. package/src/theme/defaults/dark-cosmos.json +0 -100
  311. package/src/theme/defaults/dark-cyberpunk.json +0 -112
  312. package/src/theme/defaults/dark-dracula.json +0 -108
  313. package/src/theme/defaults/dark-eclipse.json +0 -101
  314. package/src/theme/defaults/dark-ember.json +0 -105
  315. package/src/theme/defaults/dark-equinox.json +0 -100
  316. package/src/theme/defaults/dark-forest.json +0 -106
  317. package/src/theme/defaults/dark-github.json +0 -115
  318. package/src/theme/defaults/dark-gruvbox.json +0 -122
  319. package/src/theme/defaults/dark-lavender.json +0 -105
  320. package/src/theme/defaults/dark-lunar.json +0 -99
  321. package/src/theme/defaults/dark-midnight.json +0 -105
  322. package/src/theme/defaults/dark-monochrome.json +0 -104
  323. package/src/theme/defaults/dark-monokai.json +0 -108
  324. package/src/theme/defaults/dark-nebula.json +0 -100
  325. package/src/theme/defaults/dark-neon-noir.json +0 -110
  326. package/src/theme/defaults/dark-nord.json +0 -108
  327. package/src/theme/defaults/dark-ocean.json +0 -111
  328. package/src/theme/defaults/dark-one.json +0 -110
  329. package/src/theme/defaults/dark-poimandres.json +0 -125
  330. package/src/theme/defaults/dark-rainforest.json +0 -101
  331. package/src/theme/defaults/dark-reef.json +0 -101
  332. package/src/theme/defaults/dark-retro.json +0 -102
  333. package/src/theme/defaults/dark-rose-pine.json +0 -106
  334. package/src/theme/defaults/dark-sakura.json +0 -105
  335. package/src/theme/defaults/dark-slate.json +0 -105
  336. package/src/theme/defaults/dark-solarized.json +0 -107
  337. package/src/theme/defaults/dark-solstice.json +0 -100
  338. package/src/theme/defaults/dark-starfall.json +0 -101
  339. package/src/theme/defaults/dark-sunset.json +0 -109
  340. package/src/theme/defaults/dark-swamp.json +0 -100
  341. package/src/theme/defaults/dark-synthwave.json +0 -113
  342. package/src/theme/defaults/dark-taiga.json +0 -101
  343. package/src/theme/defaults/dark-terminal.json +0 -105
  344. package/src/theme/defaults/dark-tokyo-night.json +0 -111
  345. package/src/theme/defaults/dark-tundra.json +0 -101
  346. package/src/theme/defaults/dark-twilight.json +0 -101
  347. package/src/theme/defaults/dark-volcanic.json +0 -101
  348. package/src/theme/defaults/graphite.json +0 -102
  349. package/src/theme/defaults/index.d.ts +0 -10289
  350. package/src/theme/defaults/index.ts +0 -203
  351. package/src/theme/defaults/light-arctic.json +0 -117
  352. package/src/theme/defaults/light-aurora-day.json +0 -101
  353. package/src/theme/defaults/light-canyon.json +0 -101
  354. package/src/theme/defaults/light-catppuccin.json +0 -116
  355. package/src/theme/defaults/light-cirrus.json +0 -100
  356. package/src/theme/defaults/light-coral.json +0 -105
  357. package/src/theme/defaults/light-cyberpunk.json +0 -106
  358. package/src/theme/defaults/light-dawn.json +0 -100
  359. package/src/theme/defaults/light-dunes.json +0 -101
  360. package/src/theme/defaults/light-eucalyptus.json +0 -105
  361. package/src/theme/defaults/light-forest.json +0 -110
  362. package/src/theme/defaults/light-frost.json +0 -105
  363. package/src/theme/defaults/light-github.json +0 -125
  364. package/src/theme/defaults/light-glacier.json +0 -101
  365. package/src/theme/defaults/light-gruvbox.json +0 -118
  366. package/src/theme/defaults/light-haze.json +0 -100
  367. package/src/theme/defaults/light-honeycomb.json +0 -105
  368. package/src/theme/defaults/light-lagoon.json +0 -101
  369. package/src/theme/defaults/light-lavender.json +0 -105
  370. package/src/theme/defaults/light-meadow.json +0 -101
  371. package/src/theme/defaults/light-mint.json +0 -105
  372. package/src/theme/defaults/light-monochrome.json +0 -111
  373. package/src/theme/defaults/light-ocean.json +0 -109
  374. package/src/theme/defaults/light-one.json +0 -109
  375. package/src/theme/defaults/light-opal.json +0 -101
  376. package/src/theme/defaults/light-orchard.json +0 -101
  377. package/src/theme/defaults/light-paper.json +0 -105
  378. package/src/theme/defaults/light-poimandres.json +0 -125
  379. package/src/theme/defaults/light-prism.json +0 -100
  380. package/src/theme/defaults/light-retro.json +0 -108
  381. package/src/theme/defaults/light-sand.json +0 -105
  382. package/src/theme/defaults/light-savanna.json +0 -101
  383. package/src/theme/defaults/light-solarized.json +0 -112
  384. package/src/theme/defaults/light-soleil.json +0 -100
  385. package/src/theme/defaults/light-sunset.json +0 -109
  386. package/src/theme/defaults/light-synthwave.json +0 -108
  387. package/src/theme/defaults/light-tokyo-night.json +0 -121
  388. package/src/theme/defaults/light-wetland.json +0 -101
  389. package/src/theme/defaults/light-zenith.json +0 -99
  390. package/src/theme/defaults/limestone.json +0 -104
  391. package/src/theme/defaults/mahogany.json +0 -107
  392. package/src/theme/defaults/marble.json +0 -103
  393. package/src/theme/defaults/obsidian.json +0 -101
  394. package/src/theme/defaults/onyx.json +0 -101
  395. package/src/theme/defaults/pearl.json +0 -103
  396. package/src/theme/defaults/porcelain.json +0 -101
  397. package/src/theme/defaults/quartz.json +0 -106
  398. package/src/theme/defaults/sandstone.json +0 -105
  399. package/src/theme/defaults/titanium.json +0 -100
@@ -2,7 +2,7 @@ import type { StatusLineComponent } from "../status-line/component.js";
2
2
  import type { StatusLineSession } from "../status-line/host.js";
3
3
  import { type StatusLineStartupData } from "../status-line/startup.js";
4
4
  import { type Terminal } from "../terminal.js";
5
- import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
5
+ import { type Component, Container, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
6
6
  import type { NativeSurface, NativeSurfaceProvider } from "../native/node.js";
7
7
  import { CustomEditor } from "./custom-editor.js";
8
8
  import type { WordCompletionMethod } from "./word-completion.js";
@@ -61,6 +61,13 @@ export interface RuntimeChildrenOptions {
61
61
  * to the roots below the transcript in render order.
62
62
  */
63
63
  readonly nativeDock?: readonly Component[];
64
+ /**
65
+ * Below-transcript containers whose children continue `main` on a TSP
66
+ * terminal, one block each after the transcript's, instead of riding in the
67
+ * dock: output on its way into the transcript (shell runs deferred until the
68
+ * next prompt) reads as its tail, and keeps its block when it moves in.
69
+ */
70
+ readonly nativeTail?: readonly Container[];
64
71
  /**
65
72
  * Below-transcript roots the user opens and closes (the editor surface that
66
73
  * drafts and dialogs swap into, docked reports). Their rows never become
@@ -108,6 +115,19 @@ export interface ViewportClickRowTarget {
108
115
  * decides focusability and recency.
109
116
  */
110
117
  export declare function routeViewportClick(spans: readonly ViewportClickSpan[], index: number): string[];
118
+ /** An extension link label drawn on a mutable-viewport line: what a click or hint tag lands on. */
119
+ export interface ViewportLink {
120
+ readonly url: string;
121
+ /** Mutable-viewport line the label is drawn on. */
122
+ readonly row: number;
123
+ /** First cell of the label's part on that line. */
124
+ readonly start: number;
125
+ }
126
+ /**
127
+ * Called once when link-hint mode ends; `reason` is `"crowded"` when a row held more links than
128
+ * their tags could fit side by side, so no tags were drawn.
129
+ */
130
+ export type LinkHintsEnd = (reason?: "crowded") => void;
111
131
  /**
112
132
  * Reserved click-candidate id for the pinned HUD expander row. Checked before
113
133
  * any registry lookup: its `@…:…` charset cannot collide with generated agent
@@ -134,10 +154,11 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
134
154
  /**
135
155
  * Describe the whole surface for a TSP terminal. `main` is the flowing
136
156
  * document: the header (welcome, extras) and every transcript block as its
137
- * own component child. `dock` is the live chrome below the transcript in
138
- * render order: pending messages, HUDs, the working row, the editor and the
139
- * status line. There is no history/viewport split: retirement, resize
140
- * replay and hover bands are ANSI concerns.
157
+ * own component child, then the children of the
158
+ * {@link RuntimeChildrenOptions.nativeTail} roots. `dock` is the live chrome
159
+ * below the transcript in render order: pending messages, HUDs, the working
160
+ * row, the editor and the status line. There is no history/viewport split:
161
+ * retirement, resize replay and hover bands are ANSI concerns.
141
162
  */
142
163
  describeSurface(): NativeSurface;
143
164
  /**
@@ -146,11 +167,35 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
146
167
  * are never in the viewport). Callers intersect with the live registry.
147
168
  */
148
169
  viewportClickCandidates(index: number): string[];
170
+ /**
171
+ * The extension-owned link label drawn at cell `col` of a mutable-viewport line, or `undefined`.
172
+ * Only links whose scheme an extension registered match; see `extensionLinkLabels`.
173
+ */
174
+ viewportLinkAt(index: number, col: number): ViewportLink | undefined;
149
175
  /**
150
176
  * Point the hover band at a click-candidate id (or clear it). Takes effect
151
177
  * on the next frame; callers repaint only when the target actually changes.
152
178
  */
153
179
  setHoveredClickId(id: string | undefined): void;
180
+ /** How many extension link labels the last frame drew; a label wrapped across rows counts once. */
181
+ viewportLinkCount(): number;
182
+ /**
183
+ * Enter keyboard link-hint mode: the next frame draws a tag over each extension link label it
184
+ * shows. `onEnd` runs once when the mode ends: a pick, a cancel, a key no tag starts with, a
185
+ * repaint that no longer draws the tagged labels where they were, or (`"crowded"`) a row with
186
+ * too many links for their tags to fit side by side.
187
+ */
188
+ startLinkHints(onEnd: LinkHintsEnd): void;
189
+ /** Whether link-hint mode is on. */
190
+ get linkHintsActive(): boolean;
191
+ /**
192
+ * Type one letter of a tag. Returns the link whose whole tag is now typed, `true` while the
193
+ * letters still lead to several tags, and `false` when none starts with them. The mode ends on
194
+ * a pick or a miss.
195
+ */
196
+ typeLinkHint(letter: string): ViewportLink | boolean;
197
+ /** Leave link-hint mode without picking a link. */
198
+ cancelLinkHints(): void;
154
199
  /** Acknowledges one accepted header, replay, or transcript batch. */
155
200
  acknowledgeHistory(id: number): void;
156
201
  /** Render the semantic transcript tail while the terminal borrows its resize buffer. */
@@ -183,6 +228,12 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
183
228
  setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;
184
229
  /** Update the canonical editor reference after InteractiveMode remounts a custom editor. */
185
230
  setEditor(editor: CustomEditor): void;
231
+ /**
232
+ * End the startup input hold once the app's handlers are wired: the TSP
233
+ * terminal sends the typing it kept, and the keys the TUI held replay
234
+ * ({@link TUI.releaseHeldInput}). Idempotent.
235
+ */
236
+ releaseHeldInput(): void;
186
237
  /**
187
238
  * Mount the session-aware status component into the slot below the editor,
188
239
  * retiring the startup status line; the caller installs the real top-border
@@ -1,13 +1,16 @@
1
1
  /** Shared assistant transcript construction and model-authored link caching. */
2
2
  import type { AssistantMessage, Model } from "@linxiraos/pi-ai";
3
3
  import type { ImageBudget } from "../components/image.js";
4
- import type { AssistantThinkingRenderer } from "../chat/extension-types.js";
4
+ import type { AssistantTextRenderer, AssistantThinkingRenderer } from "../chat/extension-types.js";
5
5
  import { AssistantMessageComponent } from "../chat/assistant-message.js";
6
+ import { ReplyWriteComponent } from "../chat/reply-write.js";
6
7
  /** Session display capabilities supplied unchanged by the interactive host. */
7
8
  export interface AssistantMessageSession {
8
9
  readonly model?: Model;
9
10
  readonly extensionRunner?: {
10
11
  getAssistantThinkingRenderers(): readonly AssistantThinkingRenderer[];
12
+ /** Empty while the setting that enables them is off; hosts predating it may omit it. */
13
+ getAssistantTextRenderers?(): readonly AssistantTextRenderer[];
11
14
  };
12
15
  }
13
16
  /** Host state required to construct and refresh assistant transcript segments. */
@@ -42,6 +45,10 @@ export declare function assistantMessageLinkTargets(message: AssistantMessage, t
42
45
  /**
43
46
  * Construct an {@link AssistantMessageComponent} wired to the live context's
44
47
  * thinking/image settings. `message` is omitted for the streaming placeholder
45
- * component and supplied when rendering a persisted turn.
48
+ * component and supplied when rendering a persisted turn. `contentOffset` is
49
+ * the index in the full reply of the first block of a segment drawn after a
50
+ * tool call, so extension text renderers see the reply's own block indexes.
46
51
  */
47
- export declare function createAssistantMessageComponent(ctx: AssistantMessageHost, message?: AssistantMessage, linkTargets?: ReadonlyMap<string, string>): AssistantMessageComponent;
52
+ export declare function createAssistantMessageComponent(ctx: AssistantMessageHost, message?: AssistantMessage, linkTargets?: ReadonlyMap<string, string>, contentOffset?: number): AssistantMessageComponent;
53
+ /** Construct a {@link ReplyWriteComponent} (an `out://` write) drawn like the context's assistant prose. */
54
+ export declare function createReplyWriteComponent(ctx: AssistantMessageHost): ReplyWriteComponent;
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Set the registered schemes (lowercase, without `:`). Bumps {@link extensionLinksVersion} on any
3
+ * change so cached markdown renders are redrawn.
4
+ */
5
+ export declare function setExtensionLinks(next: Iterable<string>): void;
6
+ /** Changes whenever the scheme set changes; part of the markdown render cache key. */
7
+ export declare function extensionLinksVersion(): number;
8
+ /**
9
+ * Whether activating a registered-scheme link (a click or a hint tag) reaches its extension: a
10
+ * scheme is registered and the terminal is plain.
11
+ */
12
+ export declare function extensionLinksRouted(): boolean;
13
+ /**
14
+ * Set by the interactive product: whether the user has a way to pick a link drawn now (a bound
15
+ * hint key, mouse clicks). `undefined` when nothing in this process can pick one.
16
+ */
17
+ export declare function setExtensionLinkPicking(provider: (() => boolean) | undefined): void;
18
+ /**
19
+ * Whether a registered-scheme link drawn now can be activated: links are routed and the product
20
+ * offers a way to pick them. Process-wide, so a UI-less extension runner (a subagent's, whose
21
+ * transcript the user may focus) answers like the interactive one.
22
+ */
23
+ export declare function extensionLinkClicksAvailable(): boolean;
24
+ /** The registered scheme `href` uses, or `undefined` for every other link. */
25
+ export declare function extensionLinkScheme(href: string): string | undefined;
26
+ /**
27
+ * Draw an extension link's label: dotted-underlined (plain underline where the terminal has no
28
+ * styled underlines, re-applied after any style reset inside it) and wrapped in the OSC 8 marker
29
+ * {@link extensionLinkLabels} reads back in a plain terminal; as given in Tern's native view. Never
30
+ * followed by a ` (url)` suffix. `key` tells apart links of one URL drawn near each other; it must
31
+ * not change between renders of the same text, or rows rendered twice stop matching.
32
+ */
33
+ export declare function formatExtensionLink(label: string, href: string, key: string): string;
34
+ /**
35
+ * Tags for `count` links in keyboard link-hint mode: single letters while they suffice, otherwise
36
+ * two letters each, so no tag is a prefix of another. At most the alphabet squared (676) are made;
37
+ * links past that stay untagged.
38
+ */
39
+ export declare function linkHintTags(count: number): string[];
40
+ /**
41
+ * `line` without omp's extension-link markers (the OSC 8 open and close around each label), for
42
+ * terminal output. Every other hyperlink is kept as is.
43
+ */
44
+ export declare function stripExtensionLinkMarkers(line: string): string;
45
+ /** One extension link label drawn on a rendered row (before {@link stripExtensionLinkMarkers}). */
46
+ export interface ExtensionLinkLabel {
47
+ readonly url: string;
48
+ /**
49
+ * The marker's params, unique to each drawn link and repeated on every row a wrapped label
50
+ * spans, so a row's parts of one label can be told from an adjacent label of the same URL.
51
+ */
52
+ readonly id: string;
53
+ /** First 0-based cell the label covers. */
54
+ readonly start: number;
55
+ /** Cell just past the label. */
56
+ readonly end: number;
57
+ /** Whether only blank cells follow the label on its row, so a wrapped label may go on below. */
58
+ readonly endsRow: boolean;
59
+ }
60
+ /**
61
+ * The extension link labels drawn on a rendered row, left to right. Only omp's own markers with a
62
+ * registered scheme match, so ordinary hyperlinks (even of a registered scheme) and rows drawn for
63
+ * a scheme that is no longer registered never do.
64
+ */
65
+ export declare function extensionLinkLabels(line: string): ExtensionLinkLabel[];
@@ -1,14 +1,31 @@
1
1
  import type { TspSpan } from "@linxiraos/pi-wire";
2
2
  import { type TerminalId } from "../terminal-capabilities.js";
3
+ export interface FileLinkConfig {
4
+ scheme?: string;
5
+ host?: string;
6
+ }
7
+ interface FileUriOptions {
8
+ line?: number;
9
+ col?: number;
10
+ /** Native image open actions need a local file URL rather than a desktop handler. */
11
+ local?: boolean;
12
+ }
13
+ /**
14
+ * Resolve the remote file-link configuration once at host startup. Passing an
15
+ * explicit object lets SDK hosts and tests configure links without changing the
16
+ * process environment; an empty object restores ordinary file links. An invalid
17
+ * scheme or host logs a warning and keeps ordinary links.
18
+ */
19
+ export declare function applyFileLinkSetting(config?: FileLinkConfig): void;
3
20
  /**
4
- * A `file:` URL for `filePath`, or `undefined` when Node cannot encode it.
21
+ * A file-link target for `filePath`, or `undefined` when Node cannot encode it.
5
22
  *
6
23
  * Node rejects a malformed UNC target (a UNC path escaped twice by its author,
7
24
  * e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
8
25
  * A stored session keeps whatever a tool call recorded, so a transcript must
9
26
  * render such a path without a link rather than throw while it rebuilds.
10
27
  */
11
- export declare function tryFileUri(filePath: string): string | undefined;
28
+ export declare function tryFileUri(filePath: string, opts?: FileUriOptions): string | undefined;
12
29
  /**
13
30
  * Build the OSC 8 target for a file path on `terminalId`.
14
31
  *
@@ -23,7 +40,8 @@ export declare function tryFileUri(filePath: string): string | undefined;
23
40
  * The VS Code family instead navigates the documented
24
41
  * `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
25
42
  * URI is right, with the location left in the visible text — terminals that
26
- * parse a `path:line:col` suffix resolve that on their own.
43
+ * parse a `path:line:col` suffix resolve that on their own. A configured custom
44
+ * handler takes precedence and receives optional `line`/`col` query parameters.
27
45
  *
28
46
  * Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
29
47
  * target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
@@ -85,9 +103,8 @@ export declare function urlLinkSpan(target: string, displayText: string, s?: str
85
103
  /** Whether native link spans and nodes may carry an `href`: everything but an explicit `off` policy. */
86
104
  export declare function isNativeLinkEnabled(): boolean;
87
105
  /**
88
- * A native link span to a filesystem path as a plain `file://` URI (the
89
- * terminal opens it through the system; the location stays in the visible
90
- * text). Honours an explicit `off` policy.
106
+ * A native link span to a filesystem path using the configured file-link
107
+ * target. Honours an explicit `off` policy.
91
108
  */
92
109
  export declare function fileLinkSpan(filePath: string, displayText: string, s?: string): TspSpan;
93
110
  /**
@@ -101,9 +118,10 @@ export declare function fileLinkSpan(filePath: string, displayText: string, s?:
101
118
  *
102
119
  * @param filePath - Filesystem path
103
120
  * @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)
104
- * @param opts - Optional line/col position appended as `?line=N&col=M` query params
121
+ * @param opts - Optional line/col position (custom handlers use query params; VS Code uses a path suffix)
105
122
  */
106
123
  export declare function fileHyperlink(filePath: string, displayText: string, opts?: {
107
124
  line?: number;
108
125
  col?: number;
109
126
  }): string;
127
+ export {};
@@ -2,6 +2,7 @@
2
2
  * Public exports for shared TUI components.
3
3
  */
4
4
  export * from "./code-cell.js";
5
+ export * from "./extension-links.js";
5
6
  export * from "./file-list.js";
6
7
  export * from "./hyperlink.js";
7
8
  export * from "./output-block.js";
@@ -49,6 +49,8 @@ export declare const PREVIEW_LIMITS: {
49
49
  readonly EXPANDED_LINES: 12;
50
50
  /** Items (files, results) shown in collapsed view */
51
51
  readonly COLLAPSED_ITEMS: 8;
52
+ /** Definition, type-definition and implementation locations shown in collapsed view */
53
+ readonly LOCATIONS_COLLAPSED: 2;
52
54
  /** Output preview lines in collapsed view */
53
55
  readonly OUTPUT_COLLAPSED: 3;
54
56
  /** Output preview lines in expanded view */
@@ -188,11 +190,31 @@ export declare function formatErrorMessage(message: string | undefined, theme: T
188
190
  export declare function formatErrorDetail(message: string | undefined, theme: Theme): string;
189
191
  /** Render a muted empty-state message with a warning icon. */
190
192
  export declare function formatEmptyMessage(message: string, theme: Theme): string;
193
+ /**
194
+ * Color of a file's name, or a whole URL, in tool bodies: it keeps paths apart
195
+ * from the tool titles above them (bronze in titanium).
196
+ */
197
+ export declare const FILE_NAME_COLOR = "customMessageLabel";
198
+ /**
199
+ * Where a display path's final segment (file or folder name) starts, past its
200
+ * last `/` or `\` separator; a trailing-slash directory keeps its slash on the
201
+ * name. Shared by the terminal ({@link formatStyledPath}) and Tern file rows.
202
+ */
203
+ export declare function pathNameStart(filePath: string): number;
204
+ /**
205
+ * A file path in a tool body: the directory (with its trailing separator) dim,
206
+ * the final segment in {@link FILE_NAME_COLOR}. Tool headers keep paths in
207
+ * their plain subject color instead.
208
+ */
209
+ export declare function formatStyledPath(filePath: string, theme: Theme): string;
191
210
  /** Marker displayed in the gutter of a code frame. */
192
211
  export type CodeFrameMarker = "" | " " | "*" | "+" | "-" | ">";
193
212
  /** Format a code-frame row with a padded line-number gutter. */
194
213
  export declare function formatCodeFrameLine(marker: CodeFrameMarker, lineNumber: string | number, content: string, lineNumberWidth: number): string;
195
- /** Status states supported by shared tool renderer icons. */
214
+ /**
215
+ * Status states supported by shared tool renderer icons. `done` is a deprecated
216
+ * alias of `success`, kept for extension renderers.
217
+ */
196
218
  export type ToolUIStatus = "success" | "done" | "error" | "warning" | "info" | "pending" | "running" | "aborted";
197
219
  /** Semantic foreground colors used by tool renderer labels. */
198
220
  export type ToolUIColor = "success" | "error" | "warning" | "accent" | "muted";
@@ -1,7 +1,7 @@
1
1
  import type { SetupScene } from "./types.js";
2
2
  /**
3
3
  * Preview and persist the terminal glyph preset. Skipped once the Glyph
4
- * Protocol handshake confirmed the terminal renders omp's bundled icons: every
4
+ * Protocol handshake confirmed the terminal renders Zeta's bundled icons: every
5
5
  * row renders cleanly there, and the default `unicode` preset already upgrades
6
6
  * to nerd at runtime while staying safe on terminals without the protocol.
7
7
  */
@@ -1,3 +1,3 @@
1
- import type { SetupScene } from "./types.js";
1
+ import { type SetupScene } from "./types.js";
2
2
  /** Setup step that assigns one available model to the persisted default role. */
3
3
  export declare const modelSetupScene: SetupScene;
@@ -1,9 +1,10 @@
1
1
  import type { NativeNode } from "../../native/node.js";
2
2
  export declare const SETUP_OUTRO_MS = 1200;
3
3
  /**
4
- * Native outro: the shimmering mark, the saved confirmation, and an
5
- * indeterminate progress bar standing in for the timed sweep. A click sends
6
- * the `continue` action.
4
+ * Native outro, centered: the shimmering Zeta mark, "Setup saved", the
5
+ * default model now in effect (`model`, its display name, when there is
6
+ * one), and an indeterminate progress bar standing in for the timed sweep.
7
+ * A click sends the `continue` action.
7
8
  */
8
- export declare function describeSetupOutro(): NativeNode;
9
+ export declare function describeSetupOutro(model: string | undefined): NativeNode;
9
10
  export declare function renderSetupOutro(width: number, height: number, elapsedMs: number): string[];
@@ -1,10 +1,15 @@
1
1
  import { type SgrMouseEvent } from "../../mouse.js";
2
- import type { NativeNode } from "../../native/node.js";
3
- import type { SetupScene, SetupSceneController, SetupSceneHost } from "./types.js";
2
+ import type { DescribeContext, NativeNode } from "../../native/node.js";
3
+ import { type SetupScene, type SetupSceneController, type SetupSceneHost } from "./types.js";
4
4
  /**
5
5
  * "Sign in" scene: lets the user authenticate one or more model providers via
6
6
  * OAuth. It never auto-advances the wizard — the user may sign in to several
7
- * providers and then continue with Esc.
7
+ * providers and then leave the step with Esc.
8
+ *
9
+ * Picking is the provider selector (natively a setup sheet: Skip/Continue on
10
+ * Esc, Sign in on Enter); signing in is the app's {@link LoginDialogComponent},
11
+ * driven like `/login` drives it: natively its own sheet over the setup page,
12
+ * in the cell grid drawn in the wizard body in place of the selector.
8
13
  */
9
14
  export declare class SignInScene implements SetupSceneController {
10
15
  #private;
@@ -14,15 +19,15 @@ export declare class SignInScene implements SetupSceneController {
14
19
  dispose(): void;
15
20
  invalidate(): void;
16
21
  handleInput(data: string): void;
17
- /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
22
+ /** Forward mouse to the provider selector; the login dialog takes keys only. */
18
23
  routeMouse(event: SgrMouseEvent, line: number, col: number): void;
19
24
  render(width: number, maxLines?: number): readonly string[];
20
25
  /**
21
- * Picking: intro, the provider selector (describes itself) and the last
22
- * outcome. Signing in: a spinner heading, the login link (with the full
23
- * URL once, char-wrapped), any code prompt and the flow's progress lines.
26
+ * Signing in: the login dialog (its own sheet). Picking: the provider
27
+ * selector, which presents the setup sheet where the terminal draws
28
+ * pickers; elsewhere it is an inline card under the lead and the outcome.
24
29
  */
25
- describe(): NativeNode;
30
+ describe(cx: DescribeContext): NativeNode;
26
31
  }
27
32
  /** Onboarding scene for provider sign-in. */
28
33
  export declare const providersSetupScene: SetupScene;
@@ -42,7 +42,6 @@ export interface SetupHost extends SetupUiHost {
42
42
  saveColorBlindMode(enabled: boolean): void;
43
43
  saveTheme(mode: "dark" | "light", name: string): void;
44
44
  captureBrowserSession(request: OAuthBrowserSessionRequest, signal?: AbortSignal): Promise<string>;
45
- copyToClipboard(text: string): Promise<void>;
46
45
  openInBrowser(url: string): void;
47
46
  markComplete(version: number): Promise<void>;
48
47
  playWelcomeIntro(): void;
@@ -80,11 +79,27 @@ export interface SetupSceneController extends Component {
80
79
  */
81
80
  routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
82
81
  }
82
+ /**
83
+ * Role of the sheet (`picker` or `overlay`) an interactive scene presents in a
84
+ * TSP terminal. The terminal's setup stylesheet seats it under the wizard's
85
+ * brand and stepper instead of floating it over a dimmed page.
86
+ */
87
+ export declare const SETUP_SHEET_ROLE = "zeta.setup.sheet";
88
+ /** Surface role of the setup page (wizard and startup splash) in a TSP terminal. */
89
+ export declare const SETUP_SURFACE_ROLE = "zeta.app.setup";
83
90
  /** Versioned onboarding scene definition. */
84
91
  export interface SetupScene {
85
92
  id: string;
86
93
  title: string;
94
+ /** Short label for the wizard's stepper (`Sign in`, `Model`). */
95
+ step: string;
87
96
  minVersion: number;
97
+ /**
98
+ * Configures something only the cell-grid renderer draws (glyphs, composer
99
+ * shape, theme). A TSP terminal draws those itself, so the wizard skips the
100
+ * scene while a native surface is live.
101
+ */
102
+ ansiOnly?: boolean;
88
103
  shouldRun?(ctx: SetupHost): boolean | Promise<boolean>;
89
104
  mount(host: SetupSceneHost): SetupSceneController;
90
105
  }
@@ -1,4 +1,4 @@
1
- import type { SetupUiHost } from "./scenes/types.js";
1
+ import { type SetupUiHost } from "./scenes/types.js";
2
2
  /** Timing controls for the standalone startup animation. */
3
3
  export interface RunStartupSplashOptions {
4
4
  readonly durationMs?: number;
@@ -1,7 +1,9 @@
1
1
  import { type Component, type OverlayFocusOwner } from "../tui.js";
2
- import type { NativeNode, NativeUiEvent } from "../native/node.js";
2
+ import type { DescribeContext, NativeNode, NativeScreen, NativeUiEvent } from "../native/node.js";
3
3
  import type { SetupHost } from "./scenes/types.js";
4
- import type { SetupScene } from "./scenes/types.js";
4
+ import { type SetupScene } from "./scenes/types.js";
5
+ /** Whether `scene` is asked under the current renderer: a TSP surface draws `ansiOnly` settings itself. */
6
+ export declare function setupSceneApplies(scene: SetupScene): boolean;
5
7
  /** Fullscreen onboarding presentation with scene focus and mouse routing. */
6
8
  export declare class SetupWizardComponent implements Component, OverlayFocusOwner {
7
9
  #private;
@@ -14,12 +16,14 @@ export declare class SetupWizardComponent implements Component, OverlayFocusOwne
14
16
  ownsOverlayFocusTarget(component: Component): boolean;
15
17
  handleInput(data: string): void;
16
18
  render(width: number): readonly string[];
19
+ /** The wizard is a page of its own: a screen surface styled by {@link SETUP_SURFACE_ROLE}. */
20
+ describeScreen(_cx: DescribeContext): NativeScreen;
17
21
  /**
18
- * Fullscreen description: splash, the active scene inside the wizard
19
- * frame (brand header, step counter, title, footer hints), or the outro.
20
- * The splash→scene dissolve is a row effect with no native counterpart, so
21
- * a transition describes as the scene.
22
+ * Fullscreen description: splash, the active scene under the setup
23
+ * header (brand, stepper, Exit setup), or the outro. The splash→scene
24
+ * dissolve is a row effect with no native counterpart, so a transition
25
+ * describes as the scene.
22
26
  */
23
- describe(): NativeNode;
27
+ describe(cx: DescribeContext): NativeNode;
24
28
  handleNativeEvent(event: NativeUiEvent): void;
25
29
  }
@@ -21,5 +21,9 @@ export interface RunSetupWizardOptions {
21
21
  markComplete?: boolean;
22
22
  playWelcomeIntro?: boolean;
23
23
  }
24
- /** Own the fullscreen setup overlay until its scenes and outro finish. */
24
+ /**
25
+ * Own the fullscreen setup overlay until its scenes and outro finish. When
26
+ * none of `scenes` applies to the current renderer (a TSP surface skips
27
+ * `ansiOnly` ones) nothing is shown, but completion is still persisted.
28
+ */
25
29
  export declare function runSetupWizard(ctx: SetupHost, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;
@@ -114,7 +114,7 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
114
114
  setRecording(recording: boolean): void;
115
115
  /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
116
116
  setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
117
- /** Set the callback that presents the first pool-wide saved-reset expiry warning, or clear it with `undefined`. */
117
+ /** Set the callback that presents pool-wide saved-reset expiry warnings, or clear it with `undefined`. */
118
118
  setResetExpiryNoticeHandler(handler: ((notice: string) => void) | undefined): void;
119
119
  setHookStatus(key: string, text: string | undefined): void;
120
120
  watchBranch(onBranchChange: () => void): void;
@@ -98,6 +98,11 @@ export interface NonMessageTokenSource {
98
98
  readonly state?: {
99
99
  readonly tools?: readonly ContextTool[];
100
100
  };
101
+ /**
102
+ * Whether requests to `model` ship description-stripped tool specs because
103
+ * the catalog rides in the system prompt (`Agent.prunesToolDescriptions`).
104
+ */
105
+ prunesToolDescriptions?(model: Model | undefined): boolean;
101
106
  };
102
107
  readonly skills?: readonly ContextSkill[];
103
108
  /** Provider-facing, session-frozen descriptions when available. */
@@ -131,24 +136,41 @@ export interface ToolSchemaFragments {
131
136
  /** Why serialization stopped; the schema or examples after that point are missing from `fragments`. */
132
137
  readonly schemaError?: string;
133
138
  }
139
+ /** How {@link toolSchemaFragments} renders one tool definition. */
140
+ export interface ToolSchemaFragmentOptions {
141
+ /** Also return `display`: the same fragments with the schema JSON indented by this many spaces. */
142
+ displayIndent?: number;
143
+ /**
144
+ * Mirror `normalizeTools({ pruneDescriptions: true })`: the wire spec is the
145
+ * name plus the description-stripped schema, with no description or examples.
146
+ */
147
+ pruneDescriptions?: boolean;
148
+ }
134
149
  /**
135
150
  * Provider-visible text of one tool definition. `displayIndent` additionally
136
151
  * returns `display`, the same fragments with the schema JSON indented, from
137
152
  * the same schema conversion.
138
153
  */
139
- export declare function toolSchemaFragments(tool: ContextTool, displayIndent?: number): ToolSchemaFragments;
154
+ export declare function toolSchemaFragments(tool: ContextTool, options?: ToolSchemaFragmentOptions): ToolSchemaFragments;
155
+ /** Inputs that select which tool-schema estimate applies, beyond the roster and tokenizer. */
156
+ export interface ToolSchemaEstimateOptions {
157
+ /** Caller settings/source revision; a change invalidates the cached estimate. */
158
+ sourceRevision?: number;
159
+ /** Count the description-stripped specs sent when the catalog rides in the system prompt. */
160
+ pruneDescriptions?: boolean;
161
+ }
140
162
  /**
141
163
  * Estimate provider-visible tool-schema tokens.
142
164
  *
143
165
  * Results are cached by roster-array identity, tokenizer identity, the
144
- * caller-supplied settings/source revision, and the roster's explicit dynamic
145
- * metadata revision. Callers whose descriptions or schemas are live getters
146
- * must either advance `sourceRevision` or call
166
+ * caller-supplied settings/source revision, the prune mode, and the roster's
167
+ * explicit dynamic metadata revision. Callers whose descriptions or schemas are
168
+ * live getters must either advance `sourceRevision` or call
147
169
  * {@link invalidateToolSchemaMetadata} when those inputs change.
148
170
  */
149
- export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, sourceRevision?: number): number;
171
+ export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, options?: ToolSchemaEstimateOptions): number;
150
172
  /** Count schemas carried on every request, excluding server-side deferred catalogs. */
151
- export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, sourceRevision?: number): number;
173
+ export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, options?: ToolSchemaEstimateOptions): number;
152
174
  export declare function computeNonMessageTokens(session: NonMessageTokenSource, tokenizer: Tokenizer, sourceRevision?: number): number;
153
175
  /**
154
176
  * Shared helper for the four non-message token totals used by
@@ -132,8 +132,12 @@ export interface StatusLineHost<TSession extends StatusLineSession = StatusLineS
132
132
  calculateTokensPerSecond(messages: readonly AgentMessage[], isStreaming: boolean): number | null;
133
133
  limitMatchesActiveAccount(report: UsageReport, limit: UsageLimit, identity: StatusAccountIdentity): boolean;
134
134
  classifyResetExpiry?(report: UsageReport, nowMs: number): StatusResetExpiry | undefined;
135
- /** One-line warning for saved resets anywhere in the pool that expire within 24 hours. */
136
- resetExpiryNotice?(reports: readonly UsageReport[], nowMs: number): string | undefined;
135
+ /**
136
+ * One-line warning for saved resets anywhere in the pool that are about to expire.
137
+ * The host owns deduplication: a returned warning counts as shown, so each saved
138
+ * reset is warned about once, not once per refresh or conversation.
139
+ */
140
+ resetExpiryNotice?(session: TSession, reports: readonly UsageReport[], nowMs: number): string | undefined;
137
141
  computeCompactionBoundaries(session: TSession, contextWindow: number, model?: Model): CompactionBoundaries | null;
138
142
  }
139
143
  export interface FooterHost {
@@ -1,18 +1,3 @@
1
- /**
2
- * Status line for the speculative first frame, before any session exists.
3
- *
4
- * InteractiveMode persists {@link StatusLineStartupData} (settings plus the
5
- * resolved default role model and status inputs); the next launch renders it
6
- * through the real {@link StatusLineComponent} as a fresh, unnamed session at
7
- * the live terminal width. Path and git branch are read live; context usage is
8
- * reported unknown so the gauge shows the window without a percent.
9
- *
10
- * @example
11
- * ```ts ignore
12
- * const statusLine = createStartupStatusLine(cached.statusLine);
13
- * statusLine.attachToEditor(editor, getComposerStyle(shape));
14
- * ```
15
- */
16
1
  import type { ThinkingLevel } from "@linxiraos/pi-agent-core";
17
2
  import type { Model } from "@linxiraos/pi-catalog/types";
18
3
  import { StatusLineComponent } from "./component.js";
@@ -18,7 +18,7 @@ export declare enum NotifyProtocol {
18
18
  Osc99 = "\u001B]99;;",
19
19
  Osc9 = "\u001B]9;"
20
20
  }
21
- export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "zetawork" | "base" | "trueColor";
21
+ export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "warp" | "orca" | "otty" | "rio" | "tern" | "monstar" | "rex" | "zetawork" | "base" | "trueColor";
22
22
  /** Terminal capability details used for rendering and protocol selection. */
23
23
  export declare class TerminalInfo {
24
24
  readonly id: TerminalId;