@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
@@ -0,0 +1,214 @@
1
+ /**
2
+ * Links whose scheme an extension registered (`pi.registerLinkScheme`). Markdown draws them
3
+ * without the ` (url)` suffix. In a plain terminal the rendered row carries an OSC 8 marker with the
4
+ * URL so a click's cell or a hint tag can be traced back to it ({@link extensionLinkLabels}); the TUI
5
+ * strips that marker from every row it writes ({@link stripExtensionLinkMarkers}), so the terminal
6
+ * never receives the link as a hyperlink it could open.
7
+ */
8
+ import { isNativeRendering, onNativeRenderingChange } from "../native/state";
9
+ import { TERMINAL } from "../terminal-capabilities";
10
+ import { visibleWidth } from "../utils";
11
+
12
+ let schemes: ReadonlySet<string> = new Set();
13
+ let version = 0;
14
+ let pickingProvider: (() => boolean) | undefined;
15
+ // Tern's native view routes its own link clicks, so markers are drawn only for a plain terminal.
16
+ onNativeRenderingChange(() => {
17
+ version++;
18
+ });
19
+
20
+ /** One OSC 8 sequence (BEL or ST terminated); group 1 is its params, group 2 its URI (empty for a close). */
21
+ const OSC8_PATTERN = /\x1b\]8;([^;\x07\x1b]*);([^\x07\x1b]*)(?:\x07|\x1b\\)/g;
22
+
23
+ /**
24
+ * The OSC 8 params tagging omp's own markers, so they are stripped from terminal output even after
25
+ * their scheme is no longer registered. Each drawn link gets its own `-<n>` suffix, derived from the
26
+ * link itself so every render of the same text draws the same bytes; a label wrapped across rows
27
+ * repeats its marker, suffix included, on every row.
28
+ */
29
+ const MARKER_ID = "id=omp-extension-link";
30
+ const MARKER_PARAMS_PATTERN = /^id=omp-extension-link(?:-\d+)?$/;
31
+ const MARKER_OPEN = `\x1b]8;${MARKER_ID}`;
32
+
33
+ /**
34
+ * Set the registered schemes (lowercase, without `:`). Bumps {@link extensionLinksVersion} on any
35
+ * change so cached markdown renders are redrawn.
36
+ */
37
+ export function setExtensionLinks(next: Iterable<string>): void {
38
+ const nextSchemes = new Set(next);
39
+ if (nextSchemes.size === schemes.size && [...nextSchemes].every(s => schemes.has(s))) return;
40
+ schemes = nextSchemes;
41
+ version++;
42
+ }
43
+
44
+ /** Changes whenever the scheme set changes; part of the markdown render cache key. */
45
+ export function extensionLinksVersion(): number {
46
+ return version;
47
+ }
48
+
49
+ /**
50
+ * Whether activating a registered-scheme link (a click or a hint tag) reaches its extension: a
51
+ * scheme is registered and the terminal is plain.
52
+ */
53
+ export function extensionLinksRouted(): boolean {
54
+ return schemes.size > 0 && !isNativeRendering();
55
+ }
56
+
57
+ /**
58
+ * Set by the interactive product: whether the user has a way to pick a link drawn now (a bound
59
+ * hint key, mouse clicks). `undefined` when nothing in this process can pick one.
60
+ */
61
+ export function setExtensionLinkPicking(provider: (() => boolean) | undefined): void {
62
+ pickingProvider = provider;
63
+ }
64
+
65
+ /**
66
+ * Whether a registered-scheme link drawn now can be activated: links are routed and the product
67
+ * offers a way to pick them. Process-wide, so a UI-less extension runner (a subagent's, whose
68
+ * transcript the user may focus) answers like the interactive one.
69
+ */
70
+ export function extensionLinkClicksAvailable(): boolean {
71
+ return extensionLinksRouted() && pickingProvider?.() === true;
72
+ }
73
+
74
+ /** The registered scheme `href` uses, or `undefined` for every other link. */
75
+ export function extensionLinkScheme(href: string): string | undefined {
76
+ if (schemes.size === 0) return undefined;
77
+ const colon = href.indexOf(":");
78
+ if (colon <= 0) return undefined;
79
+ const scheme = href.slice(0, colon).toLowerCase();
80
+ return schemes.has(scheme) ? scheme : undefined;
81
+ }
82
+
83
+ /** Dotted underline (`4:4`) where the terminal draws styled underlines, else the plain one. */
84
+ const UNDERLINE = TERMINAL.styledUnderlines
85
+ ? { on: "\x1b[4:4m", off: "\x1b[4:0m" }
86
+ : { on: "\x1b[4m", off: "\x1b[24m" };
87
+
88
+ /** An SGR sequence; group 1 is its params. */
89
+ const SGR_PATTERN = /\x1b\[([0-9:;]*)m/g;
90
+
91
+ /** Whether an SGR with these params turns underlining off: a full reset, `24` or `4:0`. */
92
+ function endsUnderline(params: string): boolean {
93
+ const codes = params.split(";");
94
+ for (let index = 0; index < codes.length; index++) {
95
+ const code = codes[index]!;
96
+ if (code === "" || code === "0" || code === "24" || code === "4:0") return true;
97
+ // Skip a color's arguments: `38;5;n` / `38;2;r;g;b` (also 48 and 58), whose `0`s are no reset.
98
+ if (code === "38" || code === "48" || code === "58") {
99
+ const mode = codes[index + 1];
100
+ index += mode === "5" ? 2 : mode === "2" ? 4 : 0;
101
+ }
102
+ }
103
+ return false;
104
+ }
105
+
106
+ /**
107
+ * Draw an extension link's label: dotted-underlined (plain underline where the terminal has no
108
+ * styled underlines, re-applied after any style reset inside it) and wrapped in the OSC 8 marker
109
+ * {@link extensionLinkLabels} reads back in a plain terminal; as given in Tern's native view. Never
110
+ * followed by a ` (url)` suffix. `key` tells apart links of one URL drawn near each other; it must
111
+ * not change between renders of the same text, or rows rendered twice stop matching.
112
+ */
113
+ export function formatExtensionLink(label: string, href: string, key: string): string {
114
+ if (isNativeRendering()) return label;
115
+ const safe = href.replaceAll("\x1b", "").replaceAll("\x07", "");
116
+ if (!safe) return label;
117
+ const body = label.replace(SGR_PATTERN, (sequence, params: string) =>
118
+ endsUnderline(params) ? sequence + UNDERLINE.on : sequence,
119
+ );
120
+ const id = Bun.hash.crc32(`${safe}\0${key}`);
121
+ return `${MARKER_OPEN}-${id};${safe}\x07${UNDERLINE.on}${body}${UNDERLINE.off}\x1b]8;;\x07`;
122
+ }
123
+
124
+ /** Hint tag letters, home row first. */
125
+ const LINK_HINT_ALPHABET = "asdfghjklqwertyuiopzxcvbnm";
126
+
127
+ /**
128
+ * Tags for `count` links in keyboard link-hint mode: single letters while they suffice, otherwise
129
+ * two letters each, so no tag is a prefix of another. At most the alphabet squared (676) are made;
130
+ * links past that stay untagged.
131
+ */
132
+ export function linkHintTags(count: number): string[] {
133
+ if (count <= LINK_HINT_ALPHABET.length) return LINK_HINT_ALPHABET.slice(0, Math.max(0, count)).split("");
134
+ const tags: string[] = [];
135
+ for (const first of LINK_HINT_ALPHABET) {
136
+ for (const second of LINK_HINT_ALPHABET) {
137
+ if (tags.length === count) return tags;
138
+ tags.push(`${first}${second}`);
139
+ }
140
+ }
141
+ return tags;
142
+ }
143
+
144
+ /**
145
+ * `line` without omp's extension-link markers (the OSC 8 open and close around each label), for
146
+ * terminal output. Every other hyperlink is kept as is.
147
+ */
148
+ export function stripExtensionLinkMarkers(line: string): string {
149
+ if (!line.includes(MARKER_OPEN)) return line;
150
+ let inside = false;
151
+ return line.replace(OSC8_PATTERN, (sequence: string, params: string, uri: string) => {
152
+ if (uri === "") {
153
+ const closesOwn = inside;
154
+ inside = false;
155
+ return closesOwn ? "" : sequence;
156
+ }
157
+ inside = MARKER_PARAMS_PATTERN.test(params);
158
+ return inside ? "" : sequence;
159
+ });
160
+ }
161
+
162
+ /** One extension link label drawn on a rendered row (before {@link stripExtensionLinkMarkers}). */
163
+ export interface ExtensionLinkLabel {
164
+ readonly url: string;
165
+ /**
166
+ * The marker's params, unique to each drawn link and repeated on every row a wrapped label
167
+ * spans, so a row's parts of one label can be told from an adjacent label of the same URL.
168
+ */
169
+ readonly id: string;
170
+ /** First 0-based cell the label covers. */
171
+ readonly start: number;
172
+ /** Cell just past the label. */
173
+ readonly end: number;
174
+ /** Whether only blank cells follow the label on its row, so a wrapped label may go on below. */
175
+ readonly endsRow: boolean;
176
+ }
177
+
178
+ /**
179
+ * The extension link labels drawn on a rendered row, left to right. Only omp's own markers with a
180
+ * registered scheme match, so ordinary hyperlinks (even of a registered scheme) and rows drawn for
181
+ * a scheme that is no longer registered never do.
182
+ */
183
+ export function extensionLinkLabels(line: string): ExtensionLinkLabel[] {
184
+ if (schemes.size === 0 || !line.includes(MARKER_OPEN)) return [];
185
+ const labels: ExtensionLinkLabel[] = [];
186
+ let x = 0;
187
+ let cursor = 0;
188
+ /** Code-unit index where the last pushed label's text ends. */
189
+ let lastClose = 0;
190
+ let open: { url: string; id: string; start: number } | undefined;
191
+ for (const match of line.matchAll(OSC8_PATTERN)) {
192
+ x += visibleWidth(line.slice(cursor, match.index));
193
+ if (open && x > open.start) {
194
+ labels.push({ ...open, end: x, endsRow: false });
195
+ lastClose = match.index;
196
+ }
197
+ open = undefined;
198
+ const params = match[1]!;
199
+ const uri = match[2]!;
200
+ cursor = match.index + match[0].length;
201
+ if (uri && MARKER_PARAMS_PATTERN.test(params) && extensionLinkScheme(uri)) {
202
+ open = { url: uri, id: params, start: x };
203
+ }
204
+ }
205
+ x += visibleWidth(line.slice(cursor));
206
+ if (open && x > open.start) {
207
+ labels.push({ ...open, end: x, endsRow: true });
208
+ } else {
209
+ const last = labels.at(-1);
210
+ if (last && Bun.stripANSI(line.slice(lastClose)).trim() === "")
211
+ labels[labels.length - 1] = { ...last, endsRow: true };
212
+ }
213
+ return labels;
214
+ }
@@ -1,14 +1,31 @@
1
1
  import type { TspSpan } from "@linxiraos/pi-wire";
2
2
  import { type TerminalId } from "../terminal-capabilities";
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 {};
@@ -5,7 +5,9 @@
5
5
  * sequences when the active terminal supports hyperlinks and the user setting
6
6
  * permits it. Falls back to plain text when disabled.
7
7
  */
8
+ import * as os from "node:os";
8
9
  import * as url from "node:url";
10
+ import { logger } from "@linxiraos/pi-utils";
9
11
  import type { TspSpan } from "@linxiraos/pi-wire";
10
12
  import { span } from "../native/describe";
11
13
  import { setTerminalHyperlinks, TERMINAL, type TerminalId } from "../terminal-capabilities";
@@ -24,6 +26,52 @@ const DETECTED_TERMINAL_HYPERLINKS = TERMINAL.hyperlinks;
24
26
  type HyperlinkMode = "off" | "auto" | "always";
25
27
  let hyperlinkMode: HyperlinkMode = "auto";
26
28
 
29
+ export interface FileLinkConfig {
30
+ scheme?: string;
31
+ host?: string;
32
+ }
33
+
34
+ interface FileUriOptions {
35
+ line?: number;
36
+ col?: number;
37
+ /** Native image open actions need a local file URL rather than a desktop handler. */
38
+ local?: boolean;
39
+ }
40
+
41
+ let fileLinkTarget: { scheme: string; host: string } | undefined;
42
+
43
+ /** URI scheme syntax (RFC 3986 §3.1), matched after lowercasing. */
44
+ const FILE_LINK_SCHEME = /^[a-z][a-z0-9+.-]*$/;
45
+ /** A bare host name with an optional port: no userinfo, path, query, or whitespace that would reshape the URI. */
46
+ const FILE_LINK_HOST = /^[A-Za-z0-9._-]+(?::\d{1,5})?$/;
47
+
48
+ /**
49
+ * Resolve the remote file-link configuration once at host startup. Passing an
50
+ * explicit object lets SDK hosts and tests configure links without changing the
51
+ * process environment; an empty object restores ordinary file links. An invalid
52
+ * scheme or host logs a warning and keeps ordinary links.
53
+ */
54
+ export function applyFileLinkSetting(
55
+ config: FileLinkConfig = {
56
+ scheme: Bun.env.ZETA_LINK_SCHEME,
57
+ host: Bun.env.ZETA_LINK_HOST,
58
+ },
59
+ ): void {
60
+ fileLinkTarget = undefined;
61
+ if (!config.scheme) return;
62
+ const scheme = config.scheme.toLowerCase();
63
+ if (!FILE_LINK_SCHEME.test(scheme)) {
64
+ logger.warn("Invalid ZETA_LINK_SCHEME; using ordinary file links", { scheme: config.scheme });
65
+ return;
66
+ }
67
+ const host = config.host || os.hostname();
68
+ if (!FILE_LINK_HOST.test(host)) {
69
+ logger.warn("Invalid ZETA_LINK_HOST; using ordinary file links", { host });
70
+ return;
71
+ }
72
+ fileLinkTarget = { scheme, host };
73
+ }
74
+
27
75
  /** Stable 8-char hex ID derived from a URI — hints terminals to coalesce identical adjacent links. */
28
76
  function buildLinkId(uri: string): string {
29
77
  let h = 0;
@@ -35,16 +83,24 @@ function buildLinkId(uri: string): string {
35
83
  }
36
84
 
37
85
  /**
38
- * A `file:` URL for `filePath`, or `undefined` when Node cannot encode it.
86
+ * A file-link target for `filePath`, or `undefined` when Node cannot encode it.
39
87
  *
40
88
  * Node rejects a malformed UNC target (a UNC path escaped twice by its author,
41
89
  * e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
42
90
  * A stored session keeps whatever a tool call recorded, so a transcript must
43
91
  * render such a path without a link rather than throw while it rebuilds.
44
92
  */
45
- export function tryFileUri(filePath: string): string | undefined {
93
+ export function tryFileUri(filePath: string, opts?: FileUriOptions): string | undefined {
46
94
  try {
47
- return url.pathToFileURL(filePath).href;
95
+ const fileUrl = url.pathToFileURL(filePath);
96
+ if (!fileLinkTarget || opts?.local) return fileUrl.href;
97
+ // Preserve UNC servers so the handler can reconstruct the network path.
98
+ const targetPath = fileUrl.host ? `//${fileUrl.host}${fileUrl.pathname}` : fileUrl.pathname;
99
+ const position = new URLSearchParams();
100
+ if (opts?.line !== undefined) position.set("line", String(opts.line));
101
+ if (opts?.col !== undefined) position.set("col", String(opts.col));
102
+ const query = position.size ? `?${position}` : "";
103
+ return `${fileLinkTarget.scheme}://${fileLinkTarget.host}${targetPath}${query}`;
48
104
  } catch {
49
105
  return undefined;
50
106
  }
@@ -64,7 +120,8 @@ export function tryFileUri(filePath: string): string | undefined {
64
120
  * The VS Code family instead navigates the documented
65
121
  * `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
66
122
  * URI is right, with the location left in the visible text — terminals that
67
- * parse a `path:line:col` suffix resolve that on their own.
123
+ * parse a `path:line:col` suffix resolve that on their own. A configured custom
124
+ * handler takes precedence and receives optional `line`/`col` query parameters.
68
125
  *
69
126
  * Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
70
127
  * target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
@@ -74,7 +131,7 @@ export function fileUriForTerminal(
74
131
  opts: { line?: number; col?: number } | undefined,
75
132
  terminalId: TerminalId,
76
133
  ): string | undefined {
77
- if (terminalId !== "vscode") return tryFileUri(filePath);
134
+ if (fileLinkTarget || terminalId !== "vscode") return tryFileUri(filePath, opts);
78
135
  // vscode:// takes a filesystem path with forward slashes. Encode each
79
136
  // segment independently so separators and a Windows drive colon stay
80
137
  // structural while reserved bytes in file names cannot become URI syntax.
@@ -222,9 +279,8 @@ export function isNativeLinkEnabled(): boolean {
222
279
  }
223
280
 
224
281
  /**
225
- * A native link span to a filesystem path as a plain `file://` URI (the
226
- * terminal opens it through the system; the location stays in the visible
227
- * text). Honours an explicit `off` policy.
282
+ * A native link span to a filesystem path using the configured file-link
283
+ * target. Honours an explicit `off` policy.
228
284
  */
229
285
  export function fileLinkSpan(filePath: string, displayText: string, s = "path"): TspSpan {
230
286
  if (hyperlinkMode === "off") return span(displayText, s);
@@ -244,7 +300,7 @@ export function fileLinkSpan(filePath: string, displayText: string, s = "path"):
244
300
  *
245
301
  * @param filePath - Filesystem path
246
302
  * @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)
247
- * @param opts - Optional line/col position appended as `?line=N&col=M` query params
303
+ * @param opts - Optional line/col position (custom handlers use query params; VS Code uses a path suffix)
248
304
  */
249
305
  export function fileHyperlink(filePath: string, displayText: string, opts?: { line?: number; col?: number }): string {
250
306
  const uri = fileUriForTerminal(filePath, opts, TERMINAL.id);
@@ -2,6 +2,7 @@
2
2
  * Public exports for shared TUI components.
3
3
  */
4
4
  export * from "./code-cell";
5
+ export * from "./extension-links";
5
6
  export * from "./file-list";
6
7
  export * from "./hyperlink";
7
8
  export * from "./output-block";
@@ -3,6 +3,7 @@
3
3
  */
4
4
 
5
5
  export * from "./code-cell";
6
+ export * from "./extension-links";
6
7
  export * from "./file-list";
7
8
  export * from "./hyperlink";
8
9
  export * from "./output-block";
@@ -155,6 +155,8 @@ class ComposerSceneController implements SetupSceneController {
155
155
  export const composerSetupScene: SetupScene = {
156
156
  id: "composer-shape",
157
157
  title: "Choose composer shape",
158
+ step: "Composer",
158
159
  minVersion: 2,
160
+ ansiOnly: true,
159
161
  mount: host => new ComposerSceneController(host),
160
162
  };
@@ -142,7 +142,7 @@ class GlyphSceneController implements SetupSceneController {
142
142
 
143
143
  /**
144
144
  * Preview and persist the terminal glyph preset. Skipped once the Glyph
145
- * Protocol handshake confirmed the terminal renders omp's bundled icons: every
145
+ * Protocol handshake confirmed the terminal renders Zeta's bundled icons: every
146
146
  * row renders cleanly there, and the default `unicode` preset already upgrades
147
147
  * to nerd at runtime while staying safe on terminals without the protocol.
148
148
  */
@@ -151,7 +151,9 @@ export const glyphSetupScene: SetupScene = {
151
151
  get title(): string {
152
152
  return tuiText("setupGlyphTitle", "Choose glyph mode");
153
153
  },
154
+ step: "Symbols",
154
155
  minVersion: 1,
156
+ ansiOnly: true,
155
157
  shouldRun: () => !TERMINAL.glyphProtocol,
156
158
  mount: host => new GlyphSceneController(host),
157
159
  };