@linxiraos/pi-tui 1.4.6 → 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 (278) hide show
  1. package/CHANGELOG.md +194 -195
  2. package/README.md +34 -34
  3. package/dist/types/app-keybindings.d.ts +15 -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/index.d.ts +1 -0
  16. package/dist/types/chrome/transcript-notice.d.ts +35 -0
  17. package/dist/types/chrome/transcript-status.d.ts +20 -8
  18. package/dist/types/components/editor.d.ts +8 -0
  19. package/dist/types/components/markdown.d.ts +7 -0
  20. package/dist/types/native/blobs.d.ts +2 -1
  21. package/dist/types/native/picker.d.ts +4 -4
  22. package/dist/types/overlays/annotation-overlay.d.ts +7 -1
  23. package/dist/types/overlays/annotation-types.d.ts +28 -0
  24. package/dist/types/overlays/login-dialog.d.ts +5 -1
  25. package/dist/types/overlays/model-browser.d.ts +10 -1
  26. package/dist/types/overlays/oauth-selector.d.ts +23 -0
  27. package/dist/types/overlays/plan-review-overlay.d.ts +2 -0
  28. package/dist/types/overlays/rewind-selector.d.ts +1 -1
  29. package/dist/types/overlays/session-selector.d.ts +22 -2
  30. package/dist/types/prompt/composer.d.ts +43 -0
  31. package/dist/types/prompt/interactive-context-helpers.d.ts +10 -3
  32. package/dist/types/render/extension-links.d.ts +65 -0
  33. package/dist/types/render/hyperlink.d.ts +25 -7
  34. package/dist/types/render/index.d.ts +1 -0
  35. package/dist/types/setup/scenes/glyph.d.ts +1 -1
  36. package/dist/types/setup/scenes/model.d.ts +1 -1
  37. package/dist/types/setup/scenes/outro.d.ts +5 -4
  38. package/dist/types/setup/scenes/sign-in.d.ts +13 -8
  39. package/dist/types/setup/scenes/types.d.ts +16 -1
  40. package/dist/types/setup/startup-splash.d.ts +1 -1
  41. package/dist/types/setup/wizard-overlay.d.ts +11 -7
  42. package/dist/types/setup/wizard.d.ts +5 -1
  43. package/dist/types/status-line/component.d.ts +1 -1
  44. package/dist/types/status-line/context-usage.d.ts +28 -6
  45. package/dist/types/status-line/host.d.ts +6 -2
  46. package/dist/types/theme/theme.d.ts +0 -23
  47. package/dist/types/tools/bash-interactive.d.ts +6 -0
  48. package/dist/types/tools/bash.d.ts +2 -0
  49. package/dist/types/tools/default-renderer.d.ts +6 -4
  50. package/dist/types/tools/irc.d.ts +6 -0
  51. package/dist/types/tools/json-tree.d.ts +23 -4
  52. package/dist/types/tools/lsp.d.ts +2 -0
  53. package/dist/types/tools/mcp.d.ts +6 -5
  54. package/dist/types/tools/native-view.d.ts +1 -1
  55. package/dist/types/tools/renderer.d.ts +2 -0
  56. package/dist/types/tools/streaming-output.d.ts +11 -0
  57. package/dist/types/tools/task.d.ts +9 -1
  58. package/dist/types/tools/url-scheme-host.d.ts +17 -0
  59. package/dist/types/tools/yield.d.ts +1 -1
  60. package/dist/types/tui.d.ts +7 -2
  61. package/package.json +10 -14
  62. package/src/app-keybindings.d.ts +15 -0
  63. package/src/app-keybindings.ts +15 -0
  64. package/src/apps/session-picker.ts +7 -0
  65. package/src/charts/chart-plan.d.ts +9 -7
  66. package/src/charts/chart-plan.ts +20 -50
  67. package/src/chat/advisor-message.ts +2 -0
  68. package/src/chat/assistant-message.d.ts +15 -3
  69. package/src/chat/assistant-message.ts +137 -19
  70. package/src/chat/background-tan-message.ts +4 -0
  71. package/src/chat/bash-execution.d.ts +2 -0
  72. package/src/chat/bash-execution.ts +6 -0
  73. package/src/chat/chat-transcript-builder.ts +58 -28
  74. package/src/chat/compaction-summary-message.ts +2 -1
  75. package/src/chat/display-preferences.d.ts +2 -0
  76. package/src/chat/display-preferences.ts +3 -0
  77. package/src/chat/extension-types.d.ts +31 -0
  78. package/src/chat/extension-types.ts +34 -0
  79. package/src/chat/reply-write.d.ts +48 -0
  80. package/src/chat/reply-write.ts +127 -0
  81. package/src/chat/table-chart.d.ts +4 -3
  82. package/src/chat/table-chart.ts +10 -4
  83. package/src/chat/tool-execution.d.ts +1 -2
  84. package/src/chat/tool-execution.ts +20 -13
  85. package/src/chat/transcript-outline.d.ts +7 -0
  86. package/src/chat/transcript-outline.ts +27 -0
  87. package/src/chat/transcript-render-helpers.d.ts +2 -0
  88. package/src/chat/transcript-render-helpers.ts +66 -24
  89. package/src/chrome/index.ts +1 -0
  90. package/src/chrome/transcript-notice.d.ts +35 -0
  91. package/src/chrome/transcript-notice.ts +83 -0
  92. package/src/chrome/transcript-status.d.ts +20 -8
  93. package/src/chrome/transcript-status.ts +29 -29
  94. package/src/components/editor.d.ts +8 -0
  95. package/src/components/editor.ts +10 -1
  96. package/src/components/markdown.d.ts +7 -0
  97. package/src/components/markdown.ts +116 -6
  98. package/src/hotkeys-markdown.ts +1 -0
  99. package/src/native/backend.ts +5 -66
  100. package/src/native/blobs.d.ts +2 -1
  101. package/src/native/blobs.ts +3 -2
  102. package/src/native/picker.d.ts +4 -4
  103. package/src/native/picker.ts +4 -4
  104. package/src/overlays/advisor-config.ts +1 -10
  105. package/src/overlays/annotation-overlay.ts +125 -37
  106. package/src/overlays/annotation-types.ts +24 -0
  107. package/src/overlays/hook-selector.ts +2 -2
  108. package/src/overlays/login-dialog.ts +31 -5
  109. package/src/overlays/mcp-add-wizard.ts +1 -1
  110. package/src/overlays/model-browser.ts +37 -0
  111. package/src/overlays/model-hub.ts +1 -7
  112. package/src/overlays/model-picker.ts +1 -10
  113. package/src/overlays/oauth-selector.ts +44 -6
  114. package/src/overlays/plan-review-overlay.ts +13 -2
  115. package/src/overlays/rewind-selector.ts +29 -12
  116. package/src/overlays/session-selector.ts +313 -42
  117. package/src/overlays/usage-dashboard.ts +5 -12
  118. package/src/prompt/composer.ts +216 -1
  119. package/src/prompt/custom-editor.ts +6 -1
  120. package/src/prompt/emoji-autocomplete.ts +0 -2
  121. package/src/prompt/interactive-context-helpers.ts +29 -4
  122. package/src/render/extension-links.d.ts +65 -0
  123. package/src/render/extension-links.ts +214 -0
  124. package/src/render/hyperlink.d.ts +25 -7
  125. package/src/render/hyperlink.ts +65 -9
  126. package/src/render/index.d.ts +1 -0
  127. package/src/render/index.ts +1 -0
  128. package/src/setup/scenes/composer.ts +2 -0
  129. package/src/setup/scenes/glyph.ts +3 -1
  130. package/src/setup/scenes/model.ts +192 -29
  131. package/src/setup/scenes/outro.ts +33 -15
  132. package/src/setup/scenes/sign-in.ts +196 -400
  133. package/src/setup/scenes/theme.ts +2 -0
  134. package/src/setup/scenes/types.ts +18 -1
  135. package/src/setup/startup-splash.ts +8 -7
  136. package/src/setup/wizard-overlay.ts +164 -35
  137. package/src/setup/wizard.ts +11 -2
  138. package/src/status-line/component.ts +4 -10
  139. package/src/status-line/context-usage.ts +72 -21
  140. package/src/status-line/host.ts +6 -2
  141. package/src/terminal.ts +24 -2
  142. package/src/theme/defaults.json +1 -0
  143. package/src/theme/loader.ts +1 -1
  144. package/src/theme/theme.d.ts +0 -23
  145. package/src/theme/theme.ts +2 -75
  146. package/src/tools/bash-interactive.d.ts +49 -0
  147. package/src/tools/bash-interactive.ts +6 -1
  148. package/src/tools/bash.d.ts +2 -0
  149. package/src/tools/bash.ts +2 -0
  150. package/src/tools/default-renderer.d.ts +6 -4
  151. package/src/tools/default-renderer.ts +9 -6
  152. package/src/tools/eval.ts +14 -4
  153. package/src/tools/irc.d.ts +6 -0
  154. package/src/tools/irc.ts +6 -0
  155. package/src/tools/job-widget.ts +13 -1
  156. package/src/tools/json-tree.d.ts +23 -4
  157. package/src/tools/json-tree.ts +132 -42
  158. package/src/tools/lsp.d.ts +2 -0
  159. package/src/tools/lsp.ts +36 -15
  160. package/src/tools/mcp.d.ts +6 -5
  161. package/src/tools/mcp.ts +20 -12
  162. package/src/tools/native-view.d.ts +1 -1
  163. package/src/tools/native-view.ts +1 -1
  164. package/src/tools/renderer.d.ts +2 -0
  165. package/src/tools/renderer.ts +2 -0
  166. package/src/tools/streaming-output.d.ts +11 -0
  167. package/src/tools/streaming-output.ts +41 -0
  168. package/src/tools/task.d.ts +9 -1
  169. package/src/tools/task.ts +59 -16
  170. package/src/tools/url-scheme-host.d.ts +17 -0
  171. package/src/tools/url-scheme-host.ts +21 -0
  172. package/src/tools/yield.d.ts +1 -1
  173. package/src/tools/yield.ts +18 -9
  174. package/src/tui.d.ts +7 -2
  175. package/src/tui.ts +43 -15
  176. package/dist/types/theme/defaults/index.d.ts +0 -10289
  177. package/src/theme/defaults/alabaster.json +0 -103
  178. package/src/theme/defaults/amethyst.json +0 -106
  179. package/src/theme/defaults/anthracite.json +0 -103
  180. package/src/theme/defaults/basalt.json +0 -101
  181. package/src/theme/defaults/birch.json +0 -105
  182. package/src/theme/defaults/dark-abyss.json +0 -101
  183. package/src/theme/defaults/dark-arctic.json +0 -114
  184. package/src/theme/defaults/dark-aurora.json +0 -105
  185. package/src/theme/defaults/dark-catppuccin.json +0 -117
  186. package/src/theme/defaults/dark-cavern.json +0 -101
  187. package/src/theme/defaults/dark-celestial.json +0 -116
  188. package/src/theme/defaults/dark-copper.json +0 -105
  189. package/src/theme/defaults/dark-cosmos.json +0 -100
  190. package/src/theme/defaults/dark-cyberpunk.json +0 -112
  191. package/src/theme/defaults/dark-dracula.json +0 -108
  192. package/src/theme/defaults/dark-eclipse.json +0 -101
  193. package/src/theme/defaults/dark-ember.json +0 -105
  194. package/src/theme/defaults/dark-equinox.json +0 -100
  195. package/src/theme/defaults/dark-forest.json +0 -106
  196. package/src/theme/defaults/dark-github.json +0 -115
  197. package/src/theme/defaults/dark-gruvbox.json +0 -122
  198. package/src/theme/defaults/dark-lavender.json +0 -105
  199. package/src/theme/defaults/dark-lunar.json +0 -99
  200. package/src/theme/defaults/dark-midnight.json +0 -105
  201. package/src/theme/defaults/dark-monochrome.json +0 -104
  202. package/src/theme/defaults/dark-monokai.json +0 -108
  203. package/src/theme/defaults/dark-nebula.json +0 -100
  204. package/src/theme/defaults/dark-neon-noir.json +0 -110
  205. package/src/theme/defaults/dark-nord.json +0 -108
  206. package/src/theme/defaults/dark-ocean.json +0 -111
  207. package/src/theme/defaults/dark-one.json +0 -110
  208. package/src/theme/defaults/dark-poimandres.json +0 -125
  209. package/src/theme/defaults/dark-rainforest.json +0 -101
  210. package/src/theme/defaults/dark-reef.json +0 -101
  211. package/src/theme/defaults/dark-retro.json +0 -102
  212. package/src/theme/defaults/dark-rose-pine.json +0 -106
  213. package/src/theme/defaults/dark-sakura.json +0 -105
  214. package/src/theme/defaults/dark-slate.json +0 -105
  215. package/src/theme/defaults/dark-solarized.json +0 -107
  216. package/src/theme/defaults/dark-solstice.json +0 -100
  217. package/src/theme/defaults/dark-starfall.json +0 -101
  218. package/src/theme/defaults/dark-sunset.json +0 -109
  219. package/src/theme/defaults/dark-swamp.json +0 -100
  220. package/src/theme/defaults/dark-synthwave.json +0 -113
  221. package/src/theme/defaults/dark-taiga.json +0 -101
  222. package/src/theme/defaults/dark-terminal.json +0 -105
  223. package/src/theme/defaults/dark-tokyo-night.json +0 -111
  224. package/src/theme/defaults/dark-tundra.json +0 -101
  225. package/src/theme/defaults/dark-twilight.json +0 -101
  226. package/src/theme/defaults/dark-volcanic.json +0 -101
  227. package/src/theme/defaults/graphite.json +0 -102
  228. package/src/theme/defaults/index.d.ts +0 -10289
  229. package/src/theme/defaults/index.ts +0 -203
  230. package/src/theme/defaults/light-arctic.json +0 -117
  231. package/src/theme/defaults/light-aurora-day.json +0 -101
  232. package/src/theme/defaults/light-canyon.json +0 -101
  233. package/src/theme/defaults/light-catppuccin.json +0 -116
  234. package/src/theme/defaults/light-cirrus.json +0 -100
  235. package/src/theme/defaults/light-coral.json +0 -105
  236. package/src/theme/defaults/light-cyberpunk.json +0 -106
  237. package/src/theme/defaults/light-dawn.json +0 -100
  238. package/src/theme/defaults/light-dunes.json +0 -101
  239. package/src/theme/defaults/light-eucalyptus.json +0 -105
  240. package/src/theme/defaults/light-forest.json +0 -110
  241. package/src/theme/defaults/light-frost.json +0 -105
  242. package/src/theme/defaults/light-github.json +0 -125
  243. package/src/theme/defaults/light-glacier.json +0 -101
  244. package/src/theme/defaults/light-gruvbox.json +0 -118
  245. package/src/theme/defaults/light-haze.json +0 -100
  246. package/src/theme/defaults/light-honeycomb.json +0 -105
  247. package/src/theme/defaults/light-lagoon.json +0 -101
  248. package/src/theme/defaults/light-lavender.json +0 -105
  249. package/src/theme/defaults/light-meadow.json +0 -101
  250. package/src/theme/defaults/light-mint.json +0 -105
  251. package/src/theme/defaults/light-monochrome.json +0 -111
  252. package/src/theme/defaults/light-ocean.json +0 -109
  253. package/src/theme/defaults/light-one.json +0 -109
  254. package/src/theme/defaults/light-opal.json +0 -101
  255. package/src/theme/defaults/light-orchard.json +0 -101
  256. package/src/theme/defaults/light-paper.json +0 -105
  257. package/src/theme/defaults/light-poimandres.json +0 -125
  258. package/src/theme/defaults/light-prism.json +0 -100
  259. package/src/theme/defaults/light-retro.json +0 -108
  260. package/src/theme/defaults/light-sand.json +0 -105
  261. package/src/theme/defaults/light-savanna.json +0 -101
  262. package/src/theme/defaults/light-solarized.json +0 -112
  263. package/src/theme/defaults/light-soleil.json +0 -100
  264. package/src/theme/defaults/light-sunset.json +0 -109
  265. package/src/theme/defaults/light-synthwave.json +0 -108
  266. package/src/theme/defaults/light-tokyo-night.json +0 -121
  267. package/src/theme/defaults/light-wetland.json +0 -101
  268. package/src/theme/defaults/light-zenith.json +0 -99
  269. package/src/theme/defaults/limestone.json +0 -104
  270. package/src/theme/defaults/mahogany.json +0 -107
  271. package/src/theme/defaults/marble.json +0 -103
  272. package/src/theme/defaults/obsidian.json +0 -101
  273. package/src/theme/defaults/onyx.json +0 -101
  274. package/src/theme/defaults/pearl.json +0 -103
  275. package/src/theme/defaults/porcelain.json +0 -101
  276. package/src/theme/defaults/quartz.json +0 -106
  277. package/src/theme/defaults/sandstone.json +0 -105
  278. package/src/theme/defaults/titanium.json +0 -100
@@ -1,29 +1,53 @@
1
1
  import type { Model } from "@linxiraos/pi-ai";
2
2
  import { modelKind } from "@linxiraos/pi-catalog/types";
3
+ import type { TspPickerProps } from "@linxiraos/pi-wire";
3
4
  import type { SgrMouseEvent } from "../../mouse";
4
5
  import { Text } from "../../components/text";
5
6
  import { WizardStep } from "../../components/wizard-step";
6
- import { buildBrowserItems, ModelBrowser, resolveRoleAssignments, sortModelItems } from "../../overlays/model-browser";
7
+ import {
8
+ buildBrowserItems,
9
+ ModelBrowser,
10
+ type ModelBrowserItem,
11
+ resolveRoleAssignments,
12
+ sortModelItems,
13
+ } from "../../overlays/model-browser";
7
14
  import { BROWSER_FRAME_ROWS } from "../../overlays/model-picker";
8
15
  import { formatKeyHint } from "../../app-keybindings";
16
+ import { matchesKey } from "../../keys";
9
17
  import { theme } from "../../theme/theme";
10
18
  import { col, node, span, text } from "../../native/describe";
11
- import type { NativeNode } from "../../native/node";
19
+ import type { DescribeContext, NativeChild, NativeNode, NativeUiEvent } from "../../native/node";
12
20
  import { Memo } from "../../native/memo";
13
- import type { SetupScene, SetupSceneController, SetupSceneHost, StyledLine } from "./types";
21
+ import { dockedPicker, PICKER_KEY, pickerAction, pickerEvent } from "../../native/picker";
22
+ import {
23
+ SETUP_SHEET_ROLE,
24
+ type SetupScene,
25
+ type SetupSceneController,
26
+ type SetupSceneHost,
27
+ type StyledLine,
28
+ } from "./types";
14
29
 
15
30
  const MAX_VISIBLE_MODELS = 10;
31
+ const TITLE = "Choose your default model";
32
+ /** The sheet's subtitle while nothing is in flight. */
33
+ const SHEET_SUBTITLE = "Used by new sessions. Change it with /model.";
16
34
 
17
35
  class ModelSceneController implements SetupSceneController {
18
- title = "Choose your default model";
36
+ title = TITLE;
19
37
  subtitle = "Search configured models and save the model used for new sessions.";
20
38
  #browser: ModelBrowser;
21
- /** Intro override; `busy` while discovering or saving (a spinner on the native path). */
22
- #status: (StyledLine & { readonly busy: boolean }) | undefined;
23
- #selecting = false;
39
+ /** Base rows (available chat models), the picker's catalogue. */
40
+ #items: ModelBrowserItem[] = [];
41
+ #current: string | undefined;
42
+ #discovering = false;
43
+ #discoveryError: string | undefined;
44
+ /** Selector being saved as the default. */
45
+ #saving: string | undefined;
46
+ #saveError: string | undefined;
24
47
  #disposed = false;
25
48
  #step: WizardStep | undefined;
26
- #native = new Memo();
49
+ #sheet = new Memo();
50
+ #inline = new Memo();
27
51
 
28
52
  readonly #host: SetupSceneHost;
29
53
 
@@ -38,8 +62,6 @@ class ModelSceneController implements SetupSceneController {
38
62
  }
39
63
 
40
64
  async onMount(): Promise<void> {
41
- this.#status = { text: "Discovering available models…", color: "muted", busy: true };
42
- this.#host.requestRender();
43
65
  await this.#refreshModels();
44
66
  }
45
67
 
@@ -48,24 +70,30 @@ class ModelSceneController implements SetupSceneController {
48
70
  }
49
71
 
50
72
  invalidate(): void {
51
- this.#native.clear();
73
+ this.#sheet.clear();
74
+ this.#inline.clear();
52
75
  if (this.#step) this.#step.invalidate();
53
76
  else this.#browser.invalidate();
54
77
  }
55
78
 
56
79
  handleInput(data: string): void {
57
- if (this.#selecting) return;
80
+ if (this.#saving !== undefined) return;
81
+ // With nothing to pick after a failed discovery, Enter retries it (the sheet's primary action).
82
+ if (this.#canRetry() && (matchesKey(data, "enter") || matchesKey(data, "return"))) {
83
+ void this.#refreshModels();
84
+ return;
85
+ }
58
86
  if (this.#step) this.#step.handleInput(data);
59
87
  else this.#browser.handleInput(data);
60
88
  }
61
89
 
62
90
  routeMouse(event: SgrMouseEvent, line: number, col: number): void {
63
- if (this.#selecting) return;
91
+ if (this.#saving !== undefined) return;
64
92
  this.#step?.routeMouse(event, line, col);
65
93
  }
66
94
 
67
95
  render(width: number, maxLines?: number): readonly string[] {
68
- const status = this.#status;
96
+ const status = this.#status();
69
97
  const intro = new Text(
70
98
  status
71
99
  ? theme.fg(status.color, status.text)
@@ -94,12 +122,140 @@ class ModelSceneController implements SetupSceneController {
94
122
  return this.#step.render(width);
95
123
  }
96
124
 
97
- /** Intro (a spinner while models load or the choice saves) over the model browser, which describes itself. */
98
- describe(): NativeNode {
99
- const status = this.#status;
125
+ /**
126
+ * The setup sheet (search, provider-grouped models with fact columns, the
127
+ * highlighted model's details, Skip and Set as default), or where the
128
+ * terminal lacks `picker`, a status line over the browser's own list.
129
+ */
130
+ describe(cx?: DescribeContext): NativeNode {
131
+ return cx?.supports("picker") ? this.#describeSheet() : this.#describeInline();
132
+ }
133
+
134
+ /** Sheet pointer events, each on the path of the key it stands for. */
135
+ handleNativeEvent(event: NativeUiEvent): void {
136
+ const picked = pickerEvent(event, PICKER_KEY);
137
+ if (!picked || this.#saving !== undefined) return;
138
+ if (picked.kind !== "action") {
139
+ this.#browser.routePickerItem(picked.item, picked.kind === "activate");
140
+ return;
141
+ }
142
+ switch (picked.act) {
143
+ case "skip":
144
+ this.#host.finish("skipped");
145
+ return;
146
+ case "retry":
147
+ if (this.#discoveryError !== undefined) void this.#refreshModels();
148
+ return;
149
+ case "save": {
150
+ const selected = this.#browser.pickerSelected;
151
+ if (selected) this.#browser.routePickerItem(selected, true);
152
+ return;
153
+ }
154
+ case "clear":
155
+ if (this.#browser.query.length > 0) this.#browser.handleCancel();
156
+ return;
157
+ }
158
+ }
159
+
160
+ /** The latest in-flight or failed operation, as one line of status copy. */
161
+ #status(): (StyledLine & { readonly busy: boolean }) | undefined {
162
+ if (this.#saving !== undefined) {
163
+ return { text: `Saving ${this.#saving} as the default model…`, color: "muted", busy: true };
164
+ }
165
+ if (this.#saveError !== undefined) return { text: this.#saveError, color: "error", busy: false };
166
+ if (this.#discoveryError !== undefined) return { text: this.#discoveryError, color: "error", busy: false };
167
+ if (this.#discovering) return { text: "Discovering available models…", color: "muted", busy: true };
168
+ return undefined;
169
+ }
170
+
171
+ /** Discovery failed and nothing is listed: Enter and the primary action retry it. */
172
+ #canRetry(): boolean {
173
+ return this.#discoveryError !== undefined && this.#browser.pickerSelected === null;
174
+ }
175
+
176
+ #describeSheet(): NativeNode {
177
+ const browser = this.#browser;
178
+ const query = browser.query;
179
+ const filtering = query.trim().length > 0;
180
+ // Provider groups while browsing; one ranked "Matches" block while searching.
181
+ const view = browser.pickerOrder({ providers: !filtering, rest: filtering ? "Matches" : "All models" });
182
+ const catalogue = browser.pickerItems(this.#items);
183
+ const preview = browser.pickerPreview("full", this.#current);
184
+ const deps = [
185
+ catalogue,
186
+ view,
187
+ preview,
188
+ query,
189
+ browser.cursor,
190
+ browser.pickerSelected,
191
+ this.#current,
192
+ this.#discovering,
193
+ this.#discoveryError,
194
+ this.#saving,
195
+ this.#saveError,
196
+ ];
197
+ return this.#sheet.get(deps, () => {
198
+ const rows = browser.pickerRows(catalogue, view, this.#current);
199
+ const listed = view.count > 0 || query.length > 0;
200
+ const state: TspPickerProps["state"] = listed
201
+ ? "ready"
202
+ : this.#discoveryError !== undefined
203
+ ? "error"
204
+ : this.#discovering
205
+ ? "loading"
206
+ : "ready";
207
+ const saving = this.#saving !== undefined;
208
+ const retry = this.#canRetry();
209
+ const primary = retry
210
+ ? pickerAction("retry", "Retry", "enter", { primary: true })
211
+ : pickerAction("save", saving ? "Saving…" : "Set as default", "enter", {
212
+ primary: true,
213
+ ...(saving
214
+ ? { disabled: "Saving the default model" }
215
+ : rows.selected
216
+ ? {}
217
+ : { disabled: "No model highlighted" }),
218
+ });
219
+ // The reconciler hoists the picker into `layer`; the column is its place in the page.
220
+ return dockedPicker(
221
+ {
222
+ role: SETUP_SHEET_ROLE,
223
+ title: TITLE,
224
+ subtitle: this.#sheetSubtitle(),
225
+ icon: "cpu",
226
+ noun: "models",
227
+ size: "lg",
228
+ layout: "rows",
229
+ preview: "side",
230
+ placeholder: "Search models…",
231
+ ...rows,
232
+ state,
233
+ ...(state === "error" && this.#discoveryError !== undefined ? { message: this.#discoveryError } : {}),
234
+ empty: "No models yet. Skip this step and run /login to sign in to a provider.",
235
+ actions: [pickerAction("skip", "Skip", "escape", { end: true }), primary],
236
+ },
237
+ this.#saveError === undefined
238
+ ? preview
239
+ : [text([span(this.#saveError, "error")], { wrap: "word" }), ...preview],
240
+ );
241
+ });
242
+ }
243
+
244
+ #sheetSubtitle(): TspPickerProps["subtitle"] {
245
+ if (this.#saving !== undefined)
246
+ return [span("Saving "), span(this.#saving, "mono"), span(" as your default model…")];
247
+ if (this.#saveError !== undefined) return [span(`Couldn't save the default model: ${this.#saveError}`, "error")];
248
+ if (this.#discoveryError !== undefined && this.#items.length > 0) return [span(this.#discoveryError, "error")];
249
+ if (this.#discovering && this.#items.length > 0) return "Looking for more models…";
250
+ return SHEET_SUBTITLE;
251
+ }
252
+
253
+ /** Status (a spinner while models load or the choice saves) over the model browser, which describes itself. */
254
+ #describeInline(): NativeNode {
255
+ const status = this.#status();
100
256
  const enter = formatKeyHint("enter");
101
- return this.#native.get([status, enter], () => {
102
- let intro: NativeNode;
257
+ return this.#inline.get([status?.text, status?.color, status?.busy, enter], () => {
258
+ let intro: NativeChild;
103
259
  if (status?.busy) {
104
260
  intro = node("spinner", { label: [span(status.text, status.color)] });
105
261
  } else if (status) {
@@ -117,6 +273,7 @@ class ModelSceneController implements SetupSceneController {
117
273
  const roles = resolveRoleAssignments(source, all, available);
118
274
  const items = buildBrowserItems(available.filter(model => modelKind(model) === "chat"));
119
275
  sortModelItems(items, { roles, mruOrder: source.mruOrder });
276
+ this.#items = items;
120
277
  this.#browser.setRoles(roles);
121
278
  this.#browser.setMruOrder(source.mruOrder);
122
279
  this.#browser.setPerfStats(source.modelPerf);
@@ -124,37 +281,42 @@ class ModelSceneController implements SetupSceneController {
124
281
 
125
282
  if (current) {
126
283
  const selector = `${current.provider}/${current.id}`;
284
+ this.#current = selector;
127
285
  this.#browser.setCurrentSelector(selector);
128
286
  this.#browser.selectSelector(selector);
129
287
  }
130
288
  }
131
289
 
132
290
  async #refreshModels(): Promise<void> {
291
+ if (this.#discovering) return;
292
+ this.#discovering = true;
293
+ this.#discoveryError = undefined;
294
+ this.#host.requestRender();
133
295
  try {
134
296
  await this.#host.ctx.refreshModels();
135
297
  if (this.#disposed) return;
136
298
  this.#syncModels();
137
- this.#status = undefined;
138
- this.#host.requestRender();
139
299
  } catch (error) {
140
300
  if (this.#disposed) return;
141
- this.#status = { text: error instanceof Error ? error.message : String(error), color: "error", busy: false };
142
- this.#host.requestRender();
301
+ this.#discoveryError = error instanceof Error ? error.message : String(error);
302
+ } finally {
303
+ this.#discovering = false;
143
304
  }
305
+ this.#host.requestRender();
144
306
  }
145
307
 
146
308
  async #select(model: Model, selector: string): Promise<void> {
147
- if (this.#selecting) return;
148
- this.#selecting = true;
149
- this.#status = { text: `Saving ${selector} as the default model…`, color: "muted", busy: true };
309
+ if (this.#saving !== undefined) return;
310
+ this.#saving = selector;
311
+ this.#saveError = undefined;
150
312
  this.#host.requestRender();
151
313
  try {
152
314
  await this.#host.ctx.selectModel(model, selector);
153
315
  if (!this.#disposed) this.#host.finish("done");
154
316
  } catch (error) {
155
317
  if (this.#disposed) return;
156
- this.#selecting = false;
157
- this.#status = { text: error instanceof Error ? error.message : String(error), color: "error", busy: false };
318
+ this.#saving = undefined;
319
+ this.#saveError = error instanceof Error ? error.message : String(error);
158
320
  this.#host.requestRender();
159
321
  }
160
322
  }
@@ -163,7 +325,8 @@ class ModelSceneController implements SetupSceneController {
163
325
  /** Setup step that assigns one available model to the persisted default role. */
164
326
  export const modelSetupScene: SetupScene = {
165
327
  id: "model",
166
- title: "Choose your default model",
328
+ title: TITLE,
329
+ step: "Model",
167
330
  minVersion: 1,
168
331
  mount: host => new ModelSceneController(host),
169
332
  };
@@ -2,7 +2,7 @@ import { centerLine } from "../../utils";
2
2
  import { padToWidth } from "../../render/utils";
3
3
  import { theme } from "../../theme/theme";
4
4
  import { tuiText } from "../../i18n";
5
- import { col, node, span, text } from "../../native/describe";
5
+ import { col, compact, keyed, node, span, text } from "../../native/describe";
6
6
  import type { NativeNode } from "../../native/node";
7
7
  import { Memo } from "../../native/memo";
8
8
  import { renderStarfield, SETUP_TICK_MS } from "./splash";
@@ -13,23 +13,41 @@ export const SETUP_OUTRO_MS = 1200;
13
13
  const outroMemo = new Memo();
14
14
 
15
15
  /**
16
- * Native outro: the shimmering mark, the saved confirmation, and an
17
- * indeterminate progress bar standing in for the timed sweep. A click sends
18
- * the `continue` action.
16
+ * Native outro, centered: the shimmering Zeta mark, "Setup saved", the
17
+ * default model now in effect (`model`, its display name, when there is
18
+ * one), and an indeterminate progress bar standing in for the timed sweep.
19
+ * A click sends the `continue` action.
19
20
  */
20
- export function describeSetupOutro(): NativeNode {
21
- const saved = `${theme.status.success} Setup saved`;
22
- return outroMemo.get([saved], () =>
21
+ export function describeSetupOutro(model: string | undefined): NativeNode {
22
+ return outroMemo.get([model], () =>
23
23
  col(
24
- [
25
- node("spacer", { grow: 1 }),
24
+ compact([
25
+ node("spacer", { grow: 1 }, undefined, "top"),
26
26
  logoNode(ZETA_LOGO, true),
27
- text([span(saved, "success strong")], { wrap: "none" }),
28
- text([span("Handing off to the normal CLI…", "muted")], { wrap: "none" }),
29
- node("progress", { value: null, max: { w: "48ch" } }),
30
- node("spacer", { grow: 1 }),
31
- ],
32
- { align: "center", gap: "sm", grow: 1, role: "zeta.setup.outro", actions: { click: "continue" } },
27
+ keyed(
28
+ text([span("Setup saved", "success strong")], { wrap: "none", role: "zeta.setup.outro.title" }),
29
+ "title",
30
+ ),
31
+ model !== undefined &&
32
+ keyed(
33
+ text([span("Default model", "muted"), span(" · ", "dim"), span(model, "muted")], {
34
+ wrap: "none",
35
+ truncate: "end",
36
+ role: "zeta.setup.outro.model",
37
+ }),
38
+ "model",
39
+ ),
40
+ keyed(
41
+ text([span("Handing off to the normal CLI…", "muted")], {
42
+ wrap: "none",
43
+ role: "zeta.setup.outro.status",
44
+ }),
45
+ "status",
46
+ ),
47
+ node("progress", { value: null, role: "zeta.setup.outro.progress" }, undefined, "progress"),
48
+ node("spacer", { grow: 1 }, undefined, "bottom"),
49
+ ]),
50
+ { align: "center", grow: 1, role: "zeta.setup.outro", actions: { click: "continue" } },
33
51
  ),
34
52
  );
35
53
  }