@linxiraos/pi-tui 1.4.10 → 1.4.12

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 (269) hide show
  1. package/CHANGELOG.md +34 -237
  2. package/README.md +4 -1
  3. package/THIRD-PARTY-NOTICES.txt +99 -0
  4. package/dist/types/apps/shell-visualizer.d.ts +24 -0
  5. package/dist/types/autocomplete.d.ts +20 -0
  6. package/dist/types/chat/cache-invalidation-marker.d.ts +15 -7
  7. package/dist/types/chat/chat-transcript-builder.d.ts +5 -3
  8. package/dist/types/chat/display-preferences.d.ts +2 -0
  9. package/dist/types/chat/extension-types.d.ts +72 -1
  10. package/dist/types/chat/image-loading.d.ts +2 -2
  11. package/dist/types/chat/messages.d.ts +2 -3
  12. package/dist/types/chat/read-tool-group.d.ts +15 -2
  13. package/dist/types/chat/skill-message.d.ts +1 -0
  14. package/dist/types/chat/spotlight.d.ts +203 -0
  15. package/dist/types/chat/tool-execution.d.ts +26 -5
  16. package/dist/types/chat/transcript-actions.d.ts +11 -0
  17. package/dist/types/chat/transcript-browser.d.ts +9 -0
  18. package/dist/types/chat/transcript-presentation.d.ts +164 -0
  19. package/dist/types/chat/ttsr-notification.d.ts +2 -0
  20. package/dist/types/chrome/message-frame.d.ts +2 -0
  21. package/dist/types/chrome/transcript-container.d.ts +27 -6
  22. package/dist/types/components/loader.d.ts +0 -2
  23. package/dist/types/components/markdown.d.ts +11 -1
  24. package/dist/types/components/settings-list.d.ts +12 -2
  25. package/dist/types/frame-rate.d.ts +18 -0
  26. package/dist/types/index.d.ts +3 -0
  27. package/dist/types/keybinding-matchers.d.ts +4 -1
  28. package/dist/types/kitty-graphics.d.ts +1 -1
  29. package/dist/types/motion-effects.d.ts +10 -0
  30. package/dist/types/native/encode.d.ts +2 -0
  31. package/dist/types/native/measure.d.ts +10 -0
  32. package/dist/types/native/overlay.d.ts +1 -1
  33. package/dist/types/native/quiet.d.ts +5 -0
  34. package/dist/types/native/reconcile.d.ts +6 -1
  35. package/dist/types/native/spans.d.ts +6 -0
  36. package/dist/types/native/state.d.ts +4 -0
  37. package/dist/types/overlays/agent-hub.d.ts +6 -0
  38. package/dist/types/overlays/link-browser.d.ts +55 -0
  39. package/dist/types/overlays/running-subagent-badge.d.ts +1 -4
  40. package/dist/types/overlays/settings-selector.d.ts +1 -1
  41. package/dist/types/overlays/snapcompact-shape-preview.d.ts +1 -1
  42. package/dist/types/overlays/spotlight-sheet.d.ts +36 -0
  43. package/dist/types/prompt/composer-attachments.d.ts +5 -2
  44. package/dist/types/prompt/composer-cache.d.ts +7 -2
  45. package/dist/types/prompt/composer.d.ts +6 -11
  46. package/dist/types/prompt/custom-editor.d.ts +8 -2
  47. package/dist/types/prompt/gradient-highlight.d.ts +2 -2
  48. package/dist/types/prompt/magic-keywords.d.ts +2 -0
  49. package/dist/types/prompt/model-mention-autocomplete.d.ts +9 -7
  50. package/dist/types/prompt/model-mention-syntax.d.ts +6 -0
  51. package/dist/types/prompt/prompt-action-autocomplete.d.ts +2 -1
  52. package/dist/types/prompt/welcome.d.ts +19 -0
  53. package/dist/types/render/extension-links.d.ts +0 -6
  54. package/dist/types/render/index.d.ts +1 -0
  55. package/dist/types/render/link-hints.d.ts +78 -0
  56. package/dist/types/render/render-utils.d.ts +0 -2
  57. package/dist/types/setup/scenes/types.d.ts +8 -0
  58. package/dist/types/setup/scenes/updates.d.ts +6 -0
  59. package/dist/types/setup/wizard.d.ts +7 -2
  60. package/dist/types/spinner-clock.d.ts +34 -0
  61. package/dist/types/status-line/component.d.ts +8 -4
  62. package/dist/types/status-line/host.d.ts +62 -0
  63. package/dist/types/status-line/index.d.ts +1 -0
  64. package/dist/types/status-line/prompt-cache.d.ts +14 -0
  65. package/dist/types/status-line/schema.d.ts +1 -1
  66. package/dist/types/status-line/startup.d.ts +6 -0
  67. package/dist/types/status-line/types.d.ts +8 -21
  68. package/dist/types/theme/schema.d.ts +28 -1
  69. package/dist/types/theme/symbols.d.ts +1 -1
  70. package/dist/types/theme/theme-class.d.ts +12 -2
  71. package/dist/types/theme/theme.d.ts +1 -1
  72. package/dist/types/theme/tui-adapters.d.ts +7 -0
  73. package/dist/types/thinking.d.ts +12 -0
  74. package/dist/types/tools/ask.d.ts +1 -1
  75. package/dist/types/tools/bash.d.ts +21 -0
  76. package/dist/types/tools/find.d.ts +9 -1
  77. package/dist/types/tools/grep.d.ts +2 -1
  78. package/dist/types/tools/grouped-file-output.d.ts +17 -0
  79. package/dist/types/tools/job-widget.d.ts +2 -2
  80. package/dist/types/tools/lsp.d.ts +4 -2
  81. package/dist/types/tools/native-view.d.ts +4 -0
  82. package/dist/types/tools/renderer.d.ts +9 -1
  83. package/dist/types/tools/shell-trace.d.ts +10 -0
  84. package/dist/types/tools/shell-viz-render.d.ts +6 -0
  85. package/dist/types/tools/shell-viz.d.ts +16 -0
  86. package/dist/types/tools/wait.d.ts +2 -2
  87. package/dist/types/tools/web-search-types.d.ts +1 -0
  88. package/dist/types/tools/write.d.ts +2 -0
  89. package/dist/types/tui.d.ts +15 -1
  90. package/package.json +15 -11
  91. package/src/apps/shell-visualizer.d.ts +24 -0
  92. package/src/apps/shell-visualizer.ts +167 -0
  93. package/src/autocomplete.d.ts +20 -0
  94. package/src/autocomplete.ts +14 -0
  95. package/src/chat/assistant-message.ts +11 -6
  96. package/src/chat/cache-invalidation-marker.d.ts +15 -7
  97. package/src/chat/cache-invalidation-marker.ts +18 -9
  98. package/src/chat/chat-transcript-builder.d.ts +5 -3
  99. package/src/chat/chat-transcript-builder.ts +16 -12
  100. package/src/chat/display-preferences.d.ts +2 -0
  101. package/src/chat/display-preferences.ts +3 -0
  102. package/src/chat/extension-types.d.ts +72 -1
  103. package/src/chat/extension-types.ts +74 -1
  104. package/src/chat/image-loading.d.ts +2 -2
  105. package/src/chat/image-loading.ts +2 -2
  106. package/src/chat/messages.d.ts +2 -3
  107. package/src/chat/messages.ts +3 -8
  108. package/src/chat/read-tool-group.d.ts +15 -2
  109. package/src/chat/read-tool-group.ts +201 -41
  110. package/src/chat/skill-message.d.ts +1 -0
  111. package/src/chat/skill-message.ts +4 -0
  112. package/src/chat/spotlight.d.ts +203 -0
  113. package/src/chat/spotlight.ts +460 -0
  114. package/src/chat/tool-execution.d.ts +26 -5
  115. package/src/chat/tool-execution.ts +360 -38
  116. package/src/chat/transcript-actions.d.ts +11 -0
  117. package/src/chat/transcript-actions.ts +13 -1
  118. package/src/chat/transcript-browser.d.ts +9 -0
  119. package/src/chat/transcript-browser.ts +18 -0
  120. package/src/chat/transcript-presentation.d.ts +164 -0
  121. package/src/chat/transcript-presentation.ts +642 -0
  122. package/src/chat/ttsr-notification.d.ts +25 -0
  123. package/src/chat/ttsr-notification.ts +5 -0
  124. package/src/chrome/message-frame.d.ts +2 -0
  125. package/src/chrome/message-frame.ts +7 -0
  126. package/src/chrome/message-notice.d.ts +58 -0
  127. package/src/chrome/transcript-container.d.ts +27 -6
  128. package/src/chrome/transcript-container.ts +317 -66
  129. package/src/components/editor.ts +25 -1
  130. package/src/components/loader.d.ts +0 -2
  131. package/src/components/loader.ts +30 -18
  132. package/src/components/markdown.d.ts +11 -1
  133. package/src/components/markdown.ts +41 -16
  134. package/src/components/settings-list.d.ts +12 -2
  135. package/src/components/settings-list.ts +29 -13
  136. package/src/frame-rate.d.ts +18 -0
  137. package/src/frame-rate.ts +36 -0
  138. package/src/hotkeys-markdown.ts +4 -1
  139. package/src/index.d.ts +3 -0
  140. package/src/index.ts +3 -0
  141. package/src/keybinding-matchers.d.ts +4 -1
  142. package/src/keybinding-matchers.ts +13 -12
  143. package/src/kitty-graphics.d.ts +1 -1
  144. package/src/kitty-graphics.ts +3 -2
  145. package/src/motion-effects.d.ts +10 -0
  146. package/src/motion-effects.ts +27 -0
  147. package/src/native/backend.ts +66 -7
  148. package/src/native/encode.d.ts +2 -0
  149. package/src/native/encode.ts +2 -0
  150. package/src/native/measure.d.ts +10 -0
  151. package/src/native/measure.ts +185 -0
  152. package/src/native/overlay.d.ts +1 -1
  153. package/src/native/overlay.ts +1 -1
  154. package/src/native/quiet.d.ts +5 -0
  155. package/src/native/quiet.ts +105 -0
  156. package/src/native/reconcile.d.ts +6 -1
  157. package/src/native/reconcile.ts +16 -10
  158. package/src/native/spans.d.ts +6 -0
  159. package/src/native/spans.ts +40 -0
  160. package/src/native/state.d.ts +4 -0
  161. package/src/native/state.ts +18 -0
  162. package/src/overlays/agent-hub.ts +15 -2
  163. package/src/overlays/ask-dialog.ts +1 -0
  164. package/src/overlays/btw-history-panel.ts +73 -6
  165. package/src/overlays/link-browser.ts +295 -0
  166. package/src/overlays/running-subagent-badge.ts +2 -9
  167. package/src/overlays/settings-defs.ts +2 -1
  168. package/src/overlays/settings-selector.ts +18 -4
  169. package/src/overlays/snapcompact-shape-preview.ts +1 -1
  170. package/src/overlays/spotlight-sheet.ts +478 -0
  171. package/src/overlays/usage-dashboard.ts +6 -5
  172. package/src/prompt/composer-attachments.d.ts +5 -2
  173. package/src/prompt/composer-attachments.ts +6 -6
  174. package/src/prompt/composer-cache.ts +17 -16
  175. package/src/prompt/composer.ts +30 -123
  176. package/src/prompt/custom-editor.ts +17 -13
  177. package/src/prompt/gradient-highlight.d.ts +2 -2
  178. package/src/prompt/gradient-highlight.ts +5 -4
  179. package/src/prompt/magic-keywords.d.ts +2 -0
  180. package/src/prompt/magic-keywords.ts +4 -1
  181. package/src/prompt/model-mention-autocomplete.ts +73 -20
  182. package/src/prompt/model-mention-syntax.d.ts +6 -0
  183. package/src/prompt/model-mention-syntax.ts +9 -0
  184. package/src/prompt/prompt-action-autocomplete.ts +49 -33
  185. package/src/prompt/tips.txt +1 -0
  186. package/src/prompt/welcome.ts +104 -2
  187. package/src/render/extension-links.d.ts +0 -6
  188. package/src/render/extension-links.ts +0 -20
  189. package/src/render/index.d.ts +1 -0
  190. package/src/render/index.ts +1 -0
  191. package/src/render/link-hints.d.ts +78 -0
  192. package/src/render/link-hints.ts +299 -0
  193. package/src/render/render-utils.d.ts +0 -2
  194. package/src/render/render-utils.ts +0 -5
  195. package/src/setup/scenes/glyph.ts +1 -1
  196. package/src/setup/scenes/types.ts +8 -0
  197. package/src/setup/scenes/updates.ts +116 -0
  198. package/src/setup/wizard.ts +19 -8
  199. package/src/spinner-clock.d.ts +34 -0
  200. package/src/spinner-clock.ts +79 -0
  201. package/src/status-line/component.ts +145 -53
  202. package/src/status-line/host.ts +51 -0
  203. package/src/status-line/index.ts +1 -0
  204. package/src/status-line/presets.ts +3 -1
  205. package/src/status-line/prompt-cache.ts +154 -0
  206. package/src/status-line/schema.ts +1 -1
  207. package/src/status-line/segments.ts +33 -22
  208. package/src/status-line/startup.ts +23 -5
  209. package/src/status-line/types.ts +8 -22
  210. package/src/stdin-buffer.ts +89 -46
  211. package/src/terminal-capabilities.ts +3 -3
  212. package/src/terminal.ts +1 -8
  213. package/src/theme/loader.ts +3 -2
  214. package/src/theme/schema-validation.ts +1 -1
  215. package/src/theme/schema.d.ts +28 -1
  216. package/src/theme/schema.ts +30 -1
  217. package/src/theme/symbols.d.ts +1 -1
  218. package/src/theme/symbols.ts +15 -3
  219. package/src/theme/theme-class.d.ts +12 -2
  220. package/src/theme/theme-class.ts +23 -0
  221. package/src/theme/theme-schema.json +1 -1
  222. package/src/theme/theme.d.ts +1 -1
  223. package/src/theme/theme.ts +3 -7
  224. package/src/theme/tui-adapters.d.ts +7 -0
  225. package/src/theme/tui-adapters.ts +33 -1
  226. package/src/thinking.d.ts +12 -0
  227. package/src/thinking.ts +31 -0
  228. package/src/tools/ask.d.ts +1 -1
  229. package/src/tools/ask.ts +99 -38
  230. package/src/tools/ast-edit.ts +51 -32
  231. package/src/tools/ast-grep.ts +31 -19
  232. package/src/tools/bash.d.ts +21 -0
  233. package/src/tools/bash.ts +166 -24
  234. package/src/tools/find.d.ts +9 -1
  235. package/src/tools/find.ts +23 -2
  236. package/src/tools/grep.d.ts +2 -1
  237. package/src/tools/grep.ts +52 -36
  238. package/src/tools/grouped-file-output.d.ts +17 -0
  239. package/src/tools/grouped-file-output.ts +20 -2
  240. package/src/tools/job-widget.d.ts +2 -2
  241. package/src/tools/job-widget.ts +2 -2
  242. package/src/tools/lsp.d.ts +4 -2
  243. package/src/tools/lsp.ts +537 -642
  244. package/src/tools/native-view.d.ts +4 -0
  245. package/src/tools/native-view.ts +8 -2
  246. package/src/tools/renderer.d.ts +9 -1
  247. package/src/tools/renderer.ts +9 -1
  248. package/src/tools/shell-trace.d.ts +10 -0
  249. package/src/tools/shell-trace.ts +80 -0
  250. package/src/tools/shell-viz-render.d.ts +6 -0
  251. package/src/tools/shell-viz-render.ts +156 -0
  252. package/src/tools/shell-viz.d.ts +16 -0
  253. package/src/tools/shell-viz.ts +181 -0
  254. package/src/tools/streaming-output.ts +18 -8
  255. package/src/tools/task.ts +1 -1
  256. package/src/tools/wait.d.ts +2 -2
  257. package/src/tools/wait.ts +39 -34
  258. package/src/tools/web-search-types.d.ts +1 -0
  259. package/src/tools/web-search-types.ts +1 -0
  260. package/src/tools/write.d.ts +2 -0
  261. package/src/tools/write.ts +2 -0
  262. package/src/tui.d.ts +15 -1
  263. package/src/tui.ts +63 -6
  264. package/src/windows-input-mode.ts +7 -1
  265. package/dist/types/chat/collab-prompt-message.d.ts +0 -14
  266. package/dist/types/chrome/collab-qrcode.d.ts +0 -35
  267. package/src/chat/collab-prompt-message.d.ts +0 -14
  268. package/src/chat/collab-prompt-message.ts +0 -46
  269. package/src/chrome/collab-qrcode.ts +0 -99
@@ -0,0 +1,167 @@
1
+ import type { ShellVizPresentation } from "@linxiraos/pi-wire";
2
+ import { matchesKey } from "../keys";
3
+ import { node } from "../native/describe";
4
+ import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node";
5
+ import { formatDuration } from "../render/render-utils";
6
+ import { theme } from "../theme/theme";
7
+ import type { Component } from "../tui";
8
+ import { truncateToWidth, wrapTextWithAnsi } from "../utils";
9
+ import { SHELL_VIZ_LAYERS, SHELL_VIZ_VIEWS, shellVizEventAction } from "../tools/shell-trace";
10
+ import { renderShellVisualization, shellVizText } from "../tools/shell-viz-render";
11
+
12
+ /** Focused inspector host; state and replay timers remain owned by the transcript tool call. */
13
+ export interface ShellVisualizerHost {
14
+ presentation(): ShellVizPresentation | undefined;
15
+ replayEpoch(): number;
16
+ liveOrigin(): boolean;
17
+ action(value: string): void;
18
+ close(): void;
19
+ requestRender(): void;
20
+ height(): number;
21
+ }
22
+
23
+ /** Keyboard and native inspector for the exact presentation shown in the transcript. */
24
+ export class ShellVisualizer implements Component {
25
+ #scroll = 0;
26
+ #detailScroll = 0;
27
+ constructor(readonly host: ShellVisualizerHost) {}
28
+ invalidate(): void {}
29
+ handleInput(data: string): void {
30
+ const presentation = this.host.presentation();
31
+ if (matchesKey(data, "escape") || data === "q") {
32
+ this.host.close();
33
+ return;
34
+ }
35
+ if (!presentation) return;
36
+ const prefs = presentation.preferences;
37
+ const view = Number(data) - 1;
38
+ if (data === "v") {
39
+ this.#scroll = 0;
40
+ this.host.action(`view:${prefs.view === "raw" ? "pseudo" : "raw"}`);
41
+ } else if (/^[1-2]$/.test(data) && SHELL_VIZ_VIEWS[view]) {
42
+ this.#scroll = 0;
43
+ this.host.action(`view:${SHELL_VIZ_VIEWS[view]}`);
44
+ } else if (data === "c") this.host.action("layer:color");
45
+ else if (data === "i") this.host.action("layer:inline");
46
+ else if (data === "d") this.host.action("layer:idioms");
47
+ else if (data === "e") this.host.action("layer:effects");
48
+ else if (data === "u") this.host.action("layer:unwrap");
49
+ else if (data === "s") this.host.action("split");
50
+ else if (data === " ") this.host.action(prefs.playing ? "pause" : "play");
51
+ else if (data === "." || matchesKey(data, "right")) this.host.action("step");
52
+ else if (matchesKey(data, "left")) this.host.action(`seek:${Math.max(0, presentation.timeline.cursor - 1)}`);
53
+ else if (data === "r") this.host.action("reset");
54
+ else if (data === "l") this.host.action("live");
55
+ else if (data === "+" || data === "=") this.host.action(`speed:${prefs.speed < 1 ? 1 : prefs.speed < 2 ? 2 : 4}`);
56
+ else if (data === "-") this.host.action(`speed:${prefs.speed > 2 ? 2 : prefs.speed > 1 ? 1 : 0.5}`);
57
+ else if (matchesKey(data, "home")) this.host.action("seek:0");
58
+ else if (matchesKey(data, "end")) this.host.action(`seek:${presentation.timeline.length}`);
59
+ else if (data === "[") this.#detailScroll = Math.max(0, this.#detailScroll - 1);
60
+ else if (data === "]") this.#detailScroll++;
61
+ else if (matchesKey(data, "pageDown")) this.#scroll += Math.max(1, this.host.height() - 8);
62
+ else if (matchesKey(data, "pageUp"))
63
+ this.#scroll = Math.max(0, this.#scroll - Math.max(1, this.host.height() - 8));
64
+ else if (
65
+ matchesKey(data, "up") ||
66
+ data === "k" ||
67
+ matchesKey(data, "down") ||
68
+ data === "j" ||
69
+ matchesKey(data, "tab")
70
+ ) {
71
+ const nodes = [
72
+ ...new Set(
73
+ presentation.rows.flatMap(row => [
74
+ ...(row.node === undefined ? [] : [row.node]),
75
+ ...row.segments.flatMap(segment => (segment.node === undefined ? [] : [segment.node])),
76
+ ]),
77
+ ),
78
+ ];
79
+ const index = nodes.findIndex(node => node === prefs.selectedNode);
80
+ const direction = matchesKey(data, "up") || data === "k" ? -1 : 1;
81
+ const selected = nodes[(index + direction + nodes.length) % nodes.length];
82
+ if (selected !== undefined) {
83
+ this.#detailScroll = 0;
84
+ this.host.action(`select:${selected}`);
85
+ }
86
+ } else if (matchesKey(data, "enter") && prefs.selectedNode !== undefined) {
87
+ this.#detailScroll = 0;
88
+ this.host.action(`expand:${prefs.selectedNode}`);
89
+ }
90
+ this.host.requestRender();
91
+ }
92
+ handleNativeEvent(event: NativeUiEvent): void {
93
+ if (event.type === "action" && event.act === "close") {
94
+ this.host.close();
95
+ return;
96
+ }
97
+ const presentation = this.host.presentation();
98
+ const action = presentation && shellVizEventAction(event, presentation.preferences);
99
+ if (action) this.host.action(action);
100
+ }
101
+ describe(cx: DescribeContext): NativeNode {
102
+ const presentation = this.host.presentation();
103
+ if (presentation && cx.supports("shell"))
104
+ return node("shell", {
105
+ presentation,
106
+ lang: "bash",
107
+ inspector: true,
108
+ replayEpoch: this.host.replayEpoch(),
109
+ liveOrigin: this.host.liveOrigin(),
110
+ });
111
+ return node("rows", { cols: cx.cols, lines: this.render(cx.cols) });
112
+ }
113
+ render(width: number): string[] {
114
+ const presentation = this.host.presentation();
115
+ if (!presentation) return ["No complete bash command available", "Escape closes"];
116
+ const prefs = presentation.preferences;
117
+ const headings = `v Raw ↔ Pseudo · ${prefs.view === "pseudo" ? "Pseudo" : "Raw"}`;
118
+ const layers = SHELL_VIZ_LAYERS.map(layer => `${layer}:${prefs.layers[layer] ? "on" : "off"}`).join(" ");
119
+ const header = [
120
+ theme.bold("Bash visualizer · Escape closes"),
121
+ headings,
122
+ layers,
123
+ `c/i/d/e/u layers · s split:${prefs.split ? "on" : "off"} · ↑↓/Tab select · Enter details · PgUp/PgDn scroll`,
124
+ `Space ${prefs.playing ? "pause" : "play"} · ←/→ step · r reset · l live · Home/End seek · −/+ speed ${prefs.speed}× · ${formatDuration(presentation.timeline.elapsedNs / 1_000_000)} / ${formatDuration(presentation.timeline.durationNs / 1_000_000)}`,
125
+ ];
126
+ const body = renderShellVisualization(presentation, theme, width);
127
+ const selected = presentation.rows.find(
128
+ row => row.node === prefs.selectedNode || row.segments.some(segment => segment.node === prefs.selectedNode),
129
+ );
130
+ const detail: string[] = [];
131
+ if (selected) {
132
+ if (selected.detail) detail.push(shellVizText(selected.detail));
133
+ for (const segment of selected.segments) {
134
+ if (segment.tip) detail.push(shellVizText(segment.tip));
135
+ const node = segment.node ?? selected.node;
136
+ if (segment.expanded && node !== undefined && prefs.expandedNodes.includes(node))
137
+ detail.push(...segment.expanded.split("\n").map(shellVizText));
138
+ }
139
+ for (const variable of selected.annotations ?? []) {
140
+ detail.push(
141
+ `${shellVizText(variable.name)} = ${shellVizText(JSON.stringify(variable.value))}${variable.scope ? ` (${shellVizText(variable.scope)})` : ""}${variable.fullLength !== undefined && variable.fullLength > Buffer.byteLength(variable.value, "utf8") ? ` [${variable.fullLength} bytes; retained value truncated]` : ""}`,
142
+ );
143
+ }
144
+ for (const effect of selected.effects)
145
+ detail.push(`${shellVizText(effect.label)}: ${shellVizText(effect.why)}`);
146
+ }
147
+ const height = Math.max(8, this.host.height());
148
+ const wrappedDetail = detail.flatMap(line => wrapTextWithAnsi(line, Math.max(1, width)));
149
+ const detailHeight = Math.min(wrappedDetail.length, Math.floor(height / 3));
150
+ this.#detailScroll = Math.max(0, Math.min(this.#detailScroll, wrappedDetail.length - detailHeight));
151
+ const available = Math.max(1, height - header.length - detailHeight - (detailHeight ? 1 : 0));
152
+ this.#scroll = Math.max(0, Math.min(this.#scroll, body.length - available));
153
+ return [
154
+ ...header,
155
+ ...body.slice(this.#scroll, this.#scroll + available),
156
+ ...(detailHeight
157
+ ? [
158
+ theme.fg(
159
+ "dim",
160
+ `Selected details ${this.#detailScroll + 1}–${this.#detailScroll + detailHeight}/${wrappedDetail.length} · [/] scroll`,
161
+ ),
162
+ ...wrappedDetail.slice(this.#detailScroll, this.#detailScroll + detailHeight),
163
+ ]
164
+ : []),
165
+ ].map(line => truncateToWidth(line, width));
166
+ }
167
+ }
@@ -47,6 +47,21 @@ export interface AutocompleteItem {
47
47
  descriptionMatch?: boolean;
48
48
  }
49
49
  type Awaitable<T> = T | Promise<T>;
50
+ /**
51
+ * `^` model mention completion at the cursor. `unhandled` means no mention token there, or
52
+ * another completion outranks it, so the async {@link AutocompleteProvider.getSuggestions} decides.
53
+ */
54
+ export type ModelMentionCompletion = {
55
+ kind: "unhandled";
56
+ } | {
57
+ kind: "no-match";
58
+ } | {
59
+ kind: "matched";
60
+ suggestions: {
61
+ items: AutocompleteItem[];
62
+ prefix: string;
63
+ };
64
+ };
50
65
  export interface SlashCommand {
51
66
  name: string;
52
67
  aliases?: string[];
@@ -94,6 +109,11 @@ export interface AutocompleteProvider {
94
109
  items: AutocompleteItem[];
95
110
  prefix: string;
96
111
  } | null;
112
+ /**
113
+ * Synchronously list `^` model mention completions for the token at the cursor, so a
114
+ * shown mention popup never lags the typed text.
115
+ */
116
+ trySyncModelMentionCompletion?(lines: string[], cursorLine: number, cursorCol: number): ModelMentionCompletion;
97
117
  /**
98
118
  * Synchronously try to expand text immediately before the cursor (no async I/O).
99
119
  * Called after every single-character insert. Implementations MUST cheaply
@@ -236,6 +236,15 @@ export interface AutocompleteItem {
236
236
 
237
237
  type Awaitable<T> = T | Promise<T>;
238
238
 
239
+ /**
240
+ * `^` model mention completion at the cursor. `unhandled` means no mention token there, or
241
+ * another completion outranks it, so the async {@link AutocompleteProvider.getSuggestions} decides.
242
+ */
243
+ export type ModelMentionCompletion =
244
+ | { kind: "unhandled" }
245
+ | { kind: "no-match" }
246
+ | { kind: "matched"; suggestions: { items: AutocompleteItem[]; prefix: string } };
247
+
239
248
  export interface SlashCommand {
240
249
  name: string;
241
250
  aliases?: string[];
@@ -294,6 +303,11 @@ export interface AutocompleteProvider {
294
303
  * the collapsed `/skill:` namespace row. Returns null outside a command-name token or with no match.
295
304
  */
296
305
  trySyncSlashCompletion?(textBeforeCursor: string): { items: AutocompleteItem[]; prefix: string } | null;
306
+ /**
307
+ * Synchronously list `^` model mention completions for the token at the cursor, so a
308
+ * shown mention popup never lags the typed text.
309
+ */
310
+ trySyncModelMentionCompletion?(lines: string[], cursorLine: number, cursorCol: number): ModelMentionCompletion;
297
311
  /**
298
312
  * Synchronously try to expand text immediately before the cursor (no async I/O).
299
313
  * Called after every single-character insert. Implementations MUST cheaply
@@ -27,6 +27,7 @@ import { isNativeRendering } from "../native/state";
27
27
  import { NativeImageCache, nativeMediaNode } from "../native/blobs";
28
28
  import { linkedImageText } from "../prompt/image-references";
29
29
  import { Memo } from "../native/memo";
30
+ import { DEFAULT_SPINNER_INTERVAL_MS, spinnerAnimated, spinnerInterval } from "../spinner-clock";
30
31
  import { EMPTY_LINK_TARGETS, resolveImageOptions } from "../render/render-utils";
31
32
  import { WidthAwareText } from "../render";
32
33
  import { cachedPngConversion, convertImageToPngShared, imagePayloadKey } from "./image-loading";
@@ -796,17 +797,18 @@ export class AssistantMessageComponent extends Container {
796
797
  }
797
798
 
798
799
  #startThinkingAnimation(): void {
799
- // A native terminal clocks the described starburst itself.
800
- if (this.#thinkingDotsTimer || isNativeRendering()) return;
800
+ // A native terminal clocks the described starburst itself; a static spinner holds frame 0.
801
+ if (this.#thinkingDotsTimer || isNativeRendering() || !spinnerAnimated()) return;
801
802
  this.#scheduleThinkingFrame();
802
803
  }
803
804
 
804
805
  /** Eased dwell (ms) for the current pulse frame: a raised cosine over the
805
806
  * 8-frame cycle, continuous across the wrap, so the rotation breathes rather
806
- * than advancing at a fixed interval. */
807
+ * than advancing at a fixed interval. Scaled with `tui.spinnerInterval`. */
807
808
  #thinkingDotsFrameDelay(): number {
808
809
  const phase = (1 - Math.cos((2 * Math.PI * this.#thinkingDotsFrame) / THINKING_DOTS_FRAMES.length)) / 2;
809
- return THINKING_DOTS_FRAME_MS_MIN + (THINKING_DOTS_FRAME_MS_MAX - THINKING_DOTS_FRAME_MS_MIN) * phase;
810
+ const dwell = THINKING_DOTS_FRAME_MS_MIN + (THINKING_DOTS_FRAME_MS_MAX - THINKING_DOTS_FRAME_MS_MIN) * phase;
811
+ return (dwell * spinnerInterval()) / DEFAULT_SPINNER_INTERVAL_MS;
810
812
  }
811
813
 
812
814
  /** Self-rescheduling timeout (not a fixed interval) so each frame can pick its
@@ -822,11 +824,14 @@ export class AssistantMessageComponent extends Container {
822
824
  this.#stopThinkingAnimation();
823
825
  return;
824
826
  }
825
- this.#thinkingDotsFrame = (this.#thinkingDotsFrame + 1) % THINKING_DOTS_FRAMES.length;
827
+ const animated = spinnerAnimated();
828
+ // Spinners went static mid-pulse: settle on frame 0 and stop.
829
+ if (animated) this.#thinkingDotsFrame = (this.#thinkingDotsFrame + 1) % THINKING_DOTS_FRAMES.length;
830
+ else this.#thinkingDotsFrame = 0;
826
831
  if (this.#thinkingDots.setText(this.#thinkingDotsLabel())) {
827
832
  this.#onImageUpdate?.();
828
833
  }
829
- this.#scheduleThinkingFrame();
834
+ if (animated) this.#scheduleThinkingFrame();
830
835
  }
831
836
 
832
837
  #stopThinkingAnimation(): void {
@@ -10,11 +10,16 @@ export interface CacheInvalidation {
10
10
  * reusing.
11
11
  *
12
12
  * The provider reports a warm prefix as `cacheRead`; a model/thinking/tool/
13
- * system-prompt change (or a history rewrite) breaks the prefix, so the next
14
- * request reads nothing from cache and re-pays for the whole prompt. We flag
13
+ * system-prompt change, a history rewrite or an expired entry breaks the
14
+ * prefix, so the next request re-pays for the prompt past the break. We flag
15
15
  * only the transition where a demonstrably warm cache goes cold: the previous
16
- * turn must have actually READ a meaningful prefix back, and this turn's
17
- * `cacheRead` collapsed to zero while it still reprocessed a non-trivial prompt.
16
+ * turn must have actually READ a meaningful prefix back, and this turn read
17
+ * back less than half of it while it still reprocessed a non-trivial prompt.
18
+ *
19
+ * A collapse need not reach zero: the leading system/tool block is shared with
20
+ * every concurrent session on the same prompt, which keeps it warm while this
21
+ * session's history expires, so a cold turn still reads that block (~15k
22
+ * tokens) back while re-writing hundreds of thousands behind it.
18
23
  *
19
24
  * Requiring a prior warm read is deliberate. A turn that merely WROTE the prefix
20
25
  * (`cacheRead` 0) has not proven the cache is live — that is the session's first
@@ -23,11 +28,14 @@ export interface CacheInvalidation {
23
28
  * call outliving the provider's 5-minute cache TTL surfaced a spurious "cache
24
29
  * miss" right under the opening message). It also collapses a run of consecutive
25
30
  * cold turns to the single marker at the moment the cache actually broke, instead
26
- * of repeating the banner on every turn while it re-warms.
31
+ * of repeating the banner on every turn while it re-warms. Measuring the loss
32
+ * against what the predecessor READ (not what it wrote) keeps both guarantees
33
+ * when only the shared block was warm: nothing proven live was lost.
27
34
  *
28
35
  * Returns `undefined` (no marker) for the first turn, turns whose predecessor
29
- * never read a warm prefix, tiny contexts, turns that reused any cache, and —
30
- * crucially — turns on providers with *implicit* best-effort caching. Only an
36
+ * never read a warm prefix, tiny contexts, turns that read back at least half
37
+ * of the predecessor's warm prefix, and — crucially — turns on providers with
38
+ * *implicit* best-effort caching. Only an
31
39
  * explicit, prefix-controlled cache (Anthropic / Bedrock `cache_control`)
32
40
  * re-creates the prefix on a cold turn (`cacheWrite > 0`); implicit caches
33
41
  * (Google / OpenAI / Fireworks) report `cacheWrite: 0` and drop `cacheRead` to
@@ -22,11 +22,16 @@ export interface CacheInvalidation {
22
22
  * reusing.
23
23
  *
24
24
  * The provider reports a warm prefix as `cacheRead`; a model/thinking/tool/
25
- * system-prompt change (or a history rewrite) breaks the prefix, so the next
26
- * request reads nothing from cache and re-pays for the whole prompt. We flag
25
+ * system-prompt change, a history rewrite or an expired entry breaks the
26
+ * prefix, so the next request re-pays for the prompt past the break. We flag
27
27
  * only the transition where a demonstrably warm cache goes cold: the previous
28
- * turn must have actually READ a meaningful prefix back, and this turn's
29
- * `cacheRead` collapsed to zero while it still reprocessed a non-trivial prompt.
28
+ * turn must have actually READ a meaningful prefix back, and this turn read
29
+ * back less than half of it while it still reprocessed a non-trivial prompt.
30
+ *
31
+ * A collapse need not reach zero: the leading system/tool block is shared with
32
+ * every concurrent session on the same prompt, which keeps it warm while this
33
+ * session's history expires, so a cold turn still reads that block (~15k
34
+ * tokens) back while re-writing hundreds of thousands behind it.
30
35
  *
31
36
  * Requiring a prior warm read is deliberate. A turn that merely WROTE the prefix
32
37
  * (`cacheRead` 0) has not proven the cache is live — that is the session's first
@@ -35,11 +40,14 @@ export interface CacheInvalidation {
35
40
  * call outliving the provider's 5-minute cache TTL surfaced a spurious "cache
36
41
  * miss" right under the opening message). It also collapses a run of consecutive
37
42
  * cold turns to the single marker at the moment the cache actually broke, instead
38
- * of repeating the banner on every turn while it re-warms.
43
+ * of repeating the banner on every turn while it re-warms. Measuring the loss
44
+ * against what the predecessor READ (not what it wrote) keeps both guarantees
45
+ * when only the shared block was warm: nothing proven live was lost.
39
46
  *
40
47
  * Returns `undefined` (no marker) for the first turn, turns whose predecessor
41
- * never read a warm prefix, tiny contexts, turns that reused any cache, and —
42
- * crucially — turns on providers with *implicit* best-effort caching. Only an
48
+ * never read a warm prefix, tiny contexts, turns that read back at least half
49
+ * of the predecessor's warm prefix, and — crucially — turns on providers with
50
+ * *implicit* best-effort caching. Only an
43
51
  * explicit, prefix-controlled cache (Anthropic / Bedrock `cache_control`)
44
52
  * re-creates the prefix on a cold turn (`cacheWrite > 0`); implicit caches
45
53
  * (Google / OpenAI / Fireworks) report `cacheWrite: 0` and drop `cacheRead` to
@@ -53,8 +61,9 @@ export function detectCacheInvalidation(prev: Usage | undefined, current: Usage)
53
61
  // a re-write after expiry) has not proven the cache is live, so a cold turn
54
62
  // behind it is expected — not an invalidation worth surfacing.
55
63
  if (prev.cacheRead < MIN_CACHE_FOOTPRINT) return undefined;
56
- // Any cache reuse this turn means the prefix survived (at least partly).
57
- if (current.cacheRead > 0) return undefined;
64
+ // The prefix survived when this turn read back at least half of what the
65
+ // previous one did; normal turns read all of it plus the previous write.
66
+ if (current.cacheRead * 2 >= prev.cacheRead) return undefined;
58
67
  // Only an explicit, prefix-controlled cache re-creates the prefix on a cold
59
68
  // turn — Anthropic/Bedrock report that as `cacheWrite`. Implicit best-effort
60
69
  // caches (Google/OpenAI/Fireworks) report `cacheWrite: 0` and drop `cacheRead`
@@ -2,8 +2,8 @@
2
2
  * Builds transcript components from persisted session message entries — the
3
3
  * file/remote-backed counterpart to {@link UiHelpers.addMessageToChat} (which is
4
4
  * bound to the live InteractiveModeContext). Used by the fullscreen transcript
5
- * viewer ({@link AgentTranscriptViewer}) to render a parked subagent / advisor /
6
- * collab-guest transcript that has no live session.
5
+ * viewer ({@link AgentTranscriptViewer}) to render a parked subagent or advisor
6
+ * transcript that has no live session.
7
7
  *
8
8
  * Unlike incremental transcript sync, {@link ChatTranscriptBuilder.rebuild}
9
9
  * always discards prior components and rebuilds the whole transcript from the
@@ -13,7 +13,7 @@
13
13
  */
14
14
  import type { AgentTool } from "@linxiraos/pi-agent-core";
15
15
  import { type TUI } from "../tui";
16
- import type { MessageRenderer } from "./extension-types";
16
+ import type { AssistantTextRenderer, MessageRenderer } from "./extension-types";
17
17
  import { type TranscriptEntryLike as TranscriptEntry } from "./transcript-entry";
18
18
  import { TranscriptContainer } from "../chrome/transcript-container";
19
19
  export interface ChatTranscriptBuilderDeps {
@@ -30,6 +30,8 @@ export interface ChatTranscriptBuilderDeps {
30
30
  linkTargets?: ReadonlyMap<string, string>;
31
31
  /** Draw charts under numeric tables; false for transcripts that are not the main session's. Default: true. */
32
32
  tableCharts?: boolean;
33
+ /** Extension assistant text renderers the replayed replies draw with, as the live transcript does. */
34
+ textRenderers?: readonly AssistantTextRenderer[];
33
35
  requestRender: () => void;
34
36
  }
35
37
  export declare class ChatTranscriptBuilder {
@@ -2,8 +2,8 @@
2
2
  * Builds transcript components from persisted session message entries — the
3
3
  * file/remote-backed counterpart to {@link UiHelpers.addMessageToChat} (which is
4
4
  * bound to the live InteractiveModeContext). Used by the fullscreen transcript
5
- * viewer ({@link AgentTranscriptViewer}) to render a parked subagent / advisor /
6
- * collab-guest transcript that has no live session.
5
+ * viewer ({@link AgentTranscriptViewer}) to render a parked subagent or advisor
6
+ * transcript that has no live session.
7
7
  *
8
8
  * Unlike incremental transcript sync, {@link ChatTranscriptBuilder.rebuild}
9
9
  * always discards prior components and rebuilds the whole transcript from the
@@ -15,9 +15,8 @@ import type { AgentMessage, AgentTool } from "@linxiraos/pi-agent-core";
15
15
  import type { Usage } from "@linxiraos/pi-ai";
16
16
  import { type Component, type TUI } from "../tui";
17
17
  import type { AdvisorMessageDetails } from "./messages";
18
- import { COLLAB_PROMPT_MESSAGE_TYPE, type CollabPromptDetails } from "./messages";
19
18
  import { chatTranscriptDisplayPreferences as displayPreferences } from "./display-preferences";
20
- import type { MessageRenderer } from "./extension-types";
19
+ import type { AssistantTextRenderer, MessageRenderer } from "./extension-types";
21
20
  import { LAUNCH_COMPLETION_MESSAGE_TYPE } from "./messages";
22
21
  import {
23
22
  BACKGROUND_TAN_DISPATCH_MESSAGE_TYPE,
@@ -51,7 +50,6 @@ import { createBackgroundTanDispatchBlock } from "./background-tan-message";
51
50
  import { BashExecutionComponent } from "./bash-execution";
52
51
  import { detectCacheInvalidation } from "./cache-invalidation-marker";
53
52
  import { ServedModelTracker } from "./served-model-marker";
54
- import { CollabPromptMessageComponent } from "./collab-prompt-message";
55
53
  import {
56
54
  BranchSummaryMessageComponent,
57
55
  CompactionSummaryMessageComponent,
@@ -86,6 +84,8 @@ export interface ChatTranscriptBuilderDeps {
86
84
  linkTargets?: ReadonlyMap<string, string>;
87
85
  /** Draw charts under numeric tables; false for transcripts that are not the main session's. Default: true. */
88
86
  tableCharts?: boolean;
87
+ /** Extension assistant text renderers the replayed replies draw with, as the live transcript does. */
88
+ textRenderers?: readonly AssistantTextRenderer[];
89
89
  requestRender: () => void;
90
90
  }
91
91
 
@@ -246,6 +246,8 @@ export class ChatTranscriptBuilder {
246
246
  if (!this.#readGroup) {
247
247
  this.#readGroup = new ReadToolGroupComponent({
248
248
  showContentPreview: displayPreferences.readToolResultPreview,
249
+ // Extension presenters draw only the live main transcript; every replay draws stock cards.
250
+ transcriptPresenters: false,
249
251
  });
250
252
  this.#trackExpandable(this.#readGroup);
251
253
  this.container.addChild(this.#readGroup);
@@ -427,6 +429,7 @@ export class ChatTranscriptBuilder {
427
429
  proseOnlyThinking,
428
430
  this.#deps.linkTargets,
429
431
  expandThinkingBlocks,
432
+ { renderers: this.#deps.textRenderers ?? [], contentOffset: 0 },
430
433
  );
431
434
  assistantComponent.pickReactionTarget(this.container.children);
432
435
  this.#mountProse(assistantComponent);
@@ -451,7 +454,10 @@ export class ChatTranscriptBuilder {
451
454
  const errorPresentation = resolveAssistantErrorPresentation(message);
452
455
  const hasErrorStop = errorPresentation.kind === "full";
453
456
  const errorMessage = hasErrorStop ? errorPresentation.text : null;
454
- const appendAssistantSegment = (segment: Extract<AgentMessage, { role: "assistant" }> | undefined) => {
457
+ const appendAssistantSegment = (
458
+ toolCallId: string,
459
+ segment: Extract<AgentMessage, { role: "assistant" }> | undefined,
460
+ ) => {
455
461
  if (!segment || !assistantHasVisibleContent(segment)) return;
456
462
  const component = new AssistantMessageComponent(
457
463
  segment,
@@ -462,6 +468,7 @@ export class ChatTranscriptBuilder {
462
468
  proseOnlyThinking,
463
469
  this.#deps.linkTargets,
464
470
  expandThinkingBlocks,
471
+ { renderers: this.#deps.textRenderers ?? [], contentOffset: timeline.contentOffsets.get(toolCallId) ?? 0 },
465
472
  );
466
473
  this.#mountProse(component);
467
474
  lastAssistantComponent = component;
@@ -489,7 +496,7 @@ export class ChatTranscriptBuilder {
489
496
  const normalizedArgs = normalizeToolArgs(content.arguments);
490
497
  this.#readArgs.set(content.id, normalizedArgs);
491
498
  }
492
- appendAssistantSegment(afterToolSegment);
499
+ appendAssistantSegment(content.id, afterToolSegment);
493
500
  continue;
494
501
  }
495
502
 
@@ -516,6 +523,7 @@ export class ChatTranscriptBuilder {
516
523
  // Stable ids and Kitty placeholder cells keep images anchored
517
524
  // while the transcript viewport scrolls and reflows.
518
525
  showImages: displayPreferences.showImages,
526
+ transcriptPresenters: false,
519
527
  },
520
528
  this.#deps.getTool?.(content.name),
521
529
  this.#deps.ui,
@@ -536,7 +544,7 @@ export class ChatTranscriptBuilder {
536
544
  } else {
537
545
  this.#pendingTools.set(content.id, component);
538
546
  }
539
- appendAssistantSegment(afterToolSegment);
547
+ appendAssistantSegment(content.id, afterToolSegment);
540
548
  }
541
549
  const turnUsage = this.#turnUsage.add(message, this.#turnStartedAt);
542
550
  if (turnUsage) lastAssistantComponent.setTurnUsage(turnUsage);
@@ -616,10 +624,6 @@ export class ChatTranscriptBuilder {
616
624
  this.container.addChild(component);
617
625
  return;
618
626
  }
619
- if (message.customType === COLLAB_PROMPT_MESSAGE_TYPE) {
620
- this.container.addChild(new CollabPromptMessageComponent(message as CustomMessage<CollabPromptDetails>));
621
- return;
622
- }
623
627
  if (message.customType === SKILL_PROMPT_MESSAGE_TYPE) {
624
628
  const component = new SkillMessageComponent(message as CustomMessage<SkillPromptDetails>);
625
629
  this.#trackExpandable(component);
@@ -1,6 +1,8 @@
1
1
  /** Process-wide display preferences applied by the host settings hooks. */
2
2
  export interface ChatTranscriptDisplayPreferences {
3
3
  hideToolActivity: boolean;
4
+ /** Show the interactive shell execution visualization instead of the plain command. */
5
+ shellVisualization: boolean;
4
6
  readToolResultPreview: boolean;
5
7
  showImages: boolean;
6
8
  cacheMissMarker: boolean;
@@ -1,6 +1,8 @@
1
1
  /** Process-wide display preferences applied by the host settings hooks. */
2
2
  export interface ChatTranscriptDisplayPreferences {
3
3
  hideToolActivity: boolean;
4
+ /** Show the interactive shell execution visualization instead of the plain command. */
5
+ shellVisualization: boolean;
4
6
  readToolResultPreview: boolean;
5
7
  showImages: boolean;
6
8
  cacheMissMarker: boolean;
@@ -13,6 +15,7 @@ export interface ChatTranscriptDisplayPreferences {
13
15
  /** Current transcript display preferences. */
14
16
  export const chatTranscriptDisplayPreferences: ChatTranscriptDisplayPreferences = {
15
17
  hideToolActivity: false,
18
+ shellVisualization: true,
16
19
  readToolResultPreview: false,
17
20
  showImages: true,
18
21
  cacheMissMarker: false,
@@ -1,7 +1,10 @@
1
1
  import type { AssistantMessage } from "@linxiraos/pi-ai";
2
+ import type { TspText } from "@linxiraos/pi-wire";
2
3
  import type { Component, TUI } from "../tui";
3
4
  import type { Theme } from "../theme/theme";
4
- import type { CustomMessage, HookMessage } from "./messages";
5
+ import type { TodoItem } from "../tools/todo";
6
+ import type { BashExecutionMessage, CustomMessage, HookMessage, PythonExecutionMessage } from "./messages";
7
+ import type { NotificationRule } from "./ttsr-notification";
5
8
  export type ExtensionUiComponent = Component & {
6
9
  dispose?(): void;
7
10
  };
@@ -48,6 +51,74 @@ export interface AssistantTextRendering {
48
51
  /** Index in the full reply's `content` of this component's first block; a segment after a tool call starts past it. */
49
52
  contentOffset: number;
50
53
  }
54
+ /**
55
+ * One transcript block a {@link TranscriptPresenter} decides the display of. Later omp versions
56
+ * add block types; answer `undefined` for a `type` you do not know.
57
+ *
58
+ * - `toolCall`: a model tool call, `id` its `toolCallId`. `result` arrives with the call's first
59
+ * result frame; `isPartial` stays true while the call still streams progress.
60
+ * - `message`: a session message drawn as its own block, `id` the decimal `message.timestamp`
61
+ * (shared by messages recorded in the same millisecond).
62
+ * `custom` messages with `customType` `"advisor"`, `"skill-prompt"`, `"lsp-late-diagnostic"`,
63
+ * `"async-result"` or `"launch-completion"`, and `!`/`$` runs (`bashExecution`,
64
+ * `pythonExecution`). A `!`/`$` run still going has a provisional message and id; it is asked
65
+ * again with the recorded message once the session records the run. In Tern, late diagnostics
66
+ * an edit/write card takes are drawn with that card instead, so an `"lsp-late-diagnostic"`
67
+ * block appears only for the files no card took.
68
+ * - `event`: a TTSR rule hit or an incomplete-todo reminder, shaped like the extension event of
69
+ * the same `type`. These exist only in the session that raised them; `id` is unique per process.
70
+ *
71
+ * Read-only, and not a copy: `args`, `result`'s `content` and `details`, `message` and `event`
72
+ * are the live objects omp draws the block from, often the session's own message data. Never
73
+ * mutate them: the change would reach the block and possibly the session.
74
+ */
75
+ export type TranscriptBlock = {
76
+ readonly type: "toolCall";
77
+ readonly id: string;
78
+ readonly toolName: string;
79
+ readonly args: unknown;
80
+ readonly result?: {
81
+ readonly content: readonly unknown[];
82
+ readonly details?: unknown;
83
+ };
84
+ readonly isError: boolean;
85
+ readonly isPartial: boolean;
86
+ } | {
87
+ readonly type: "message";
88
+ readonly id: string;
89
+ readonly message: CustomMessage | BashExecutionMessage | PythonExecutionMessage;
90
+ } | {
91
+ readonly type: "event";
92
+ readonly id: string;
93
+ readonly event: {
94
+ readonly type: "ttsr_triggered";
95
+ readonly rules: readonly NotificationRule[];
96
+ } | {
97
+ readonly type: "todo_reminder";
98
+ readonly todos: readonly TodoItem[];
99
+ readonly attempt: number;
100
+ readonly maxAttempts: number;
101
+ };
102
+ };
103
+ /**
104
+ * How a transcript block is drawn: `undefined` defers to the next presenter (and, after the
105
+ * last, to `"full"`); `"full"` is omp's own card; `"hidden"` draws nothing, as hidden tool
106
+ * activity does; `"compact"` is one row from omp's own summary. `{ compact: { label, rows } }`
107
+ * replaces that row's text with `label` and adds one row per `rows` entry below it. Spans use the
108
+ * semantic tokens and theme colour names of {@link TspText}.
109
+ */
110
+ export type TranscriptPresentation = undefined | "full" | "hidden" | "compact" | {
111
+ readonly compact: {
112
+ readonly label?: TspText;
113
+ readonly rows?: readonly TspText[];
114
+ };
115
+ };
116
+ /**
117
+ * Display-only choice of how one transcript block is drawn. Presenters are asked in extension
118
+ * load order; the first answer other than `undefined` wins. A block the user expanded is always
119
+ * drawn in full.
120
+ */
121
+ export type TranscriptPresenter = (block: TranscriptBlock) => TranscriptPresentation;
51
122
  export interface HookMessageRenderOptions {
52
123
  /** Whether the view is expanded */
53
124
  expanded: boolean;