@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
@@ -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.js";
3
4
  import type { Theme } from "../theme/theme.js";
4
- import type { CustomMessage, HookMessage } from "./messages.js";
5
+ import type { TodoItem } from "../tools/todo.js";
6
+ import type { BashExecutionMessage, CustomMessage, HookMessage, PythonExecutionMessage } from "./messages.js";
7
+ import type { NotificationRule } from "./ttsr-notification.js";
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;
@@ -5,12 +5,12 @@ export declare const SUPPORTED_INPUT_IMAGE_MIME_TYPES: Set<string>;
5
5
  * Ollama and its local-backend family decode image input through llama.cpp /
6
6
  * `stb_image`, which is compiled without WebP support, so a WebP upload fails
7
7
  * with an opaque HTTP 400. Detect those models so the resize pipeline encodes
8
- * to PNG/JPEG instead — the automatic equivalent of `OMP_NO_WEBP=1`.
8
+ * to PNG/JPEG instead — the automatic equivalent of `ZETA_NO_WEBP=1`.
9
9
  */
10
10
  export declare function modelLacksWebpSupport(model: Pick<Model, "provider" | "api" | "imageInputDecoder"> | undefined): boolean;
11
11
  /**
12
12
  * `true` when `model` cannot decode WebP, otherwise `undefined` so the
13
- * `OMP_NO_WEBP` env fallback in {@link resizeImage} still applies. Feed straight
13
+ * `ZETA_NO_WEBP` env fallback in {@link resizeImage} still applies. Feed straight
14
14
  * into {@link ImageResizeOptions.excludeWebP}.
15
15
  */
16
16
  export declare function webpExclusionForModel(model: Pick<Model, "provider" | "api"> | undefined): true | undefined;
@@ -12,7 +12,6 @@ declare module "@linxiraos/pi-agent-core" {
12
12
  fileMention: FileMentionMessage;
13
13
  }
14
14
  }
15
- export { COLLAB_PROMPT_MESSAGE_TYPE, type CollabPromptDetails } from "@linxiraos/pi-wire";
16
15
  export type { BranchSummaryMessage, CompactionSummaryMessage } from "@linxiraos/pi-agent-core/compaction/messages";
17
16
  export declare const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
18
17
  export declare const LSP_LATE_DIAGNOSTIC_MESSAGE_TYPE = "lsp-late-diagnostic";
@@ -169,8 +168,8 @@ export interface FileMentionMessage {
169
168
  export declare function isUserInvokedSkillPrompt(message: CustomMessage): boolean;
170
169
  /**
171
170
  * True for a custom message that initiates a user-attributed turn: a directly
172
- * invoked `/skill:` prompt or a writable-collab peer's prompt. Agent redirects,
173
- * reminders, and auto-continues are not turn starts.
171
+ * invoked `/skill:` prompt. Agent redirects, reminders, and auto-continues are
172
+ * not turn starts.
174
173
  */
175
174
  export declare function isUserTurnInitiator(message: CustomMessage): boolean;
176
175
  /** Advisor note severities, weakest first; ranks severity thresholds such as `advisor.continueSeverity`. */
@@ -21,12 +21,21 @@ export declare function readArgsCollapseIntoGroup(args: unknown): boolean;
21
21
  export declare function groupedReadUsageCallIds(message: AssistantMessage): string[] | undefined;
22
22
  type ReadToolGroupOptions = {
23
23
  showContentPreview?: boolean;
24
+ /** Ask the extension transcript presenters; false for a replayed transcript (overlays). Default: true. */
25
+ transcriptPresenters?: boolean;
24
26
  };
25
27
  export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
26
28
  #private;
27
29
  constructor(options?: ReadToolGroupOptions);
30
+ /**
31
+ * Reads a presenter leaves full draw as the group, at the first full read's place; a compact
32
+ * read is a row of its own; hidden draws nothing.
33
+ */
28
34
  render(width: number): readonly string[];
35
+ refreshTranscriptPresentation(ids?: ReadonlySet<string>): boolean;
29
36
  isTranscriptBlockFinalized(): boolean;
37
+ /** Compact only while every read it draws is a compact row. */
38
+ isTranscriptBlockCompact(): boolean;
30
39
  finalize(): void;
31
40
  /**
32
41
  * Force the group terminal even if an entry never received its result (the
@@ -63,11 +72,14 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
63
72
  setExecutionStarted(_toolCallId?: string): void;
64
73
  setExpanded(expanded: boolean): void;
65
74
  setToolActivityVisible(visible: boolean): void;
75
+ /** The reads' Spotlight notices, in order: blocks of their own right after the group's card. */
76
+ nativeTrailers(): readonly Component[];
66
77
  getComponent(): Component;
67
78
  /**
68
79
  * Mirrors the terminal's toggles: the `tool` head (the group's root) is
69
80
  * `Ctrl+O`'s expansion; a fallback preview card collapses on its own
70
- * (`setExpanded` resets those).
81
+ * (`setExpanded` resets those). A compact read's row (`c<id>`) opens that
82
+ * read; the full rows beside compact ones (`full`) open and close their reads.
71
83
  */
72
84
  handleNativeEvent(event: NativeUiEvent): void;
73
85
  /**
@@ -75,7 +87,8 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
75
87
  * the fallback: a bare `card` (role `zeta.tool.read`) with `Read <path>` or
76
88
  * `Read (N)` in the head, a `list` of path items (status tone, link,
77
89
  * correction and conflict detail, nested usage) and a clamped preview per
78
- * read when content previews are on.
90
+ * read when content previews are on. Compact reads become rows of their
91
+ * own (keyed `c<toolCallId>`) beside that group.
79
92
  */
80
93
  describe(cx?: DescribeContext): NativeNode;
81
94
  }
@@ -18,6 +18,7 @@ export declare class SkillMessageComponent extends Container {
18
18
  #private;
19
19
  constructor(message: CustomMessage<SkillPromptDetails>, imageLinks?: readonly (string | undefined)[]);
20
20
  setExpanded(expanded: boolean): void;
21
+ isExpanded(): boolean;
21
22
  handleNativeEvent(event: NativeUiEvent): void;
22
23
  /**
23
24
  * A user-toned card (role `zeta.skill`): the skill chip (linked to its
@@ -0,0 +1,203 @@
1
+ import type { TspPropNode, TspTone } from "@linxiraos/pi-wire";
2
+ import type { NativeNode, NativeUiEvent } from "../native/node.js";
3
+ import type { Component } from "../tui.js";
4
+ /** Original lines a result's heat and the sheet cover; later lines are shown in neither. */
5
+ export declare const SPOTLIGHT_VIEW_LINES = 5000;
6
+ /** The original of a result whose text shaping changed. */
7
+ export interface SpotlightOriginal {
8
+ /** Session artifact holding the original text (`artifact://N`). */
9
+ url: string;
10
+ /** Its line count. */
11
+ lines: number;
12
+ /** Line number of its first line: a `read` window's first file line, else 1. */
13
+ start: number;
14
+ /** The file a `read` showed (picks the sheet's grammar). */
15
+ path?: string;
16
+ /**
17
+ * One character per original line, from its first (at most {@link SPOTLIGHT_VIEW_LINES}): Spotlight's score as
18
+ * `0`–`9` relative to the result's hottest line, `-` for a line it never scored. Lines past the end are unscored.
19
+ */
20
+ heat: string;
21
+ /** Runs of original lines the model was shown verbatim, `[first, last]` 1-based positions in the original. */
22
+ kept: [number, number][];
23
+ /**
24
+ * One {@link SpotlightReason} character per original line, over the span {@link heat} covers: why shaping showed or
25
+ * hid the line. Absent on traces written before it.
26
+ */
27
+ why?: string;
28
+ /** How the step that cut by rank chose its lines; absent when no step ranked them. */
29
+ rank?: SpotlightRank;
30
+ /**
31
+ * One entry per line of the text the model saw (of a held-out result: the text it would have seen): the original
32
+ * line it shows (1-based position in the original), the `[first, last]` run a marker stands for, or null for a line
33
+ * of its own (a shaping note).
34
+ */
35
+ map?: (number | [number, number] | null)[];
36
+ /** A held-out result's would-be text, the cut the model was not shown (`artifact://N`). */
37
+ shapedUrl?: string;
38
+ }
39
+ /**
40
+ * Why shaping showed or hid one original line ({@link SpotlightOriginal.why}). Shown: `a` won on its score, `s`
41
+ * structure kept regardless of score (head and tail lines, signatures, headings, table headers), `n` named by the
42
+ * intent or the conversation, `c` context (a neighbour of a chosen line, or a lone gap filled). Hidden: `b` ranked
43
+ * below the cutoff or past the budget, `r` seen in an earlier call, `f` folded by structure (an outline body, a doc
44
+ * section, test-run noise, dump rows). `-` unknown.
45
+ */
46
+ export type SpotlightReason = "a" | "s" | "n" | "c" | "b" | "r" | "f" | "-";
47
+ /** Whether a {@link SpotlightReason} shows the line. */
48
+ export declare function reasonShows(reason: SpotlightReason): boolean;
49
+ /** The reason for original line `i` (0-based), or undefined past the trace or without one. */
50
+ export declare function reasonAt(why: string | undefined, i: number): SpotlightReason | undefined;
51
+ /**
52
+ * The ranking of the step that cut by rank ({@link SpotlightOriginal.rank}): a line's score is the sum of its parts,
53
+ * and the step kept the best lines while its budget lasted.
54
+ */
55
+ export interface SpotlightRank {
56
+ /**
57
+ * The parts a score adds up, in order, each in [0, 1] (shaping writes one; older traces may carry two, the ranks of
58
+ * `Spotlight` and of `word overlap`).
59
+ */
60
+ parts: string[];
61
+ /** The highest score a line can reach. */
62
+ max: number;
63
+ /** Per part, its value on every original line over the span {@link SpotlightOriginal.heat} covers ({@link encodeRankPart}). */
64
+ values: string[];
65
+ /** The lowest score the step kept on rank. */
66
+ cutoff: number;
67
+ /** Characters the step could show, and how many it showed; absent for a step with no character budget. */
68
+ budget?: number;
69
+ used?: number;
70
+ /** The last line kept on rank (1-based position in the original) and the characters it cost. */
71
+ last?: {
72
+ line: number;
73
+ chars: number;
74
+ };
75
+ }
76
+ /** One {@link SpotlightRank.values} entry: two base-36 digits per line, each value relative to `max`. */
77
+ export declare function encodeRankPart(values: readonly number[], max: number): string;
78
+ /** The value of original line `i` (0-based) in an {@link encodeRankPart} string; 0 past its end. */
79
+ export declare function rankPartAt(encoded: string, i: number, max: number): number;
80
+ /**
81
+ * What a result's Spotlight requests sent besides the output lines they ranked (`POST /v1/spotlight`): the agent's
82
+ * state at the call, the command that produced the output, the question its lines were ranked under, and the model.
83
+ */
84
+ export interface SpotlightRequestParams {
85
+ /** The user's first message of the session. */
86
+ task: string;
87
+ /** Up to three earlier bash commands of the session, oldest first. */
88
+ commands: string[];
89
+ /** The agent's text before the call. */
90
+ said: string;
91
+ /** The call's intent argument. */
92
+ intent: string;
93
+ /** The command, code or `read <path>` that produced the output. */
94
+ source: string;
95
+ /** The probe the lines were ranked under: Spotlight scores each line's relevance to the agent's current call. */
96
+ probe: string;
97
+ model: string;
98
+ thinking: string;
99
+ }
100
+ /** `details.spotlight`: one tool result as shaping left it. */
101
+ export interface SpotlightDetails {
102
+ tool: string;
103
+ /** The shaping steps that ran (`outline`, `window`, …; `none` for a passthrough). */
104
+ steps: string[];
105
+ inChars: number;
106
+ outChars: number;
107
+ /** o200k tokens of the original and of the text the model saw. */
108
+ inTokens: number;
109
+ outTokens: number;
110
+ /**
111
+ * Size of the plain (unshaped) result for the same call (a spilled output's capped text, a read's page), notices
112
+ * included. Absent on traces written before pi recorded it.
113
+ */
114
+ plainChars?: number;
115
+ plainTokens?: number;
116
+ /**
117
+ * `plainTokens - outTokens` for a changed (or held-out) result, else 0: negative for a column-cap cut longer than
118
+ * the preview it replaced. On older traces `inTokens - outTokens`.
119
+ */
120
+ savedTokens: number;
121
+ /** The score-free coin skipped Spotlight: the result was shaped by the no-score rules. Absent otherwise. */
122
+ scoreFree?: boolean;
123
+ /**
124
+ * The cut saved too few tokens against the plain result to apply, so the model got the plain text (`steps` ends
125
+ * with `plain-cap`, the out sizes are the plain text's): the would-be cut's size. Absent otherwise.
126
+ */
127
+ cappedChars?: number;
128
+ cappedTokens?: number;
129
+ /**
130
+ * Shaping would have changed the text, but the result was held out at random: the model saw the plain result. The
131
+ * sizes, steps and {@link original} describe the would-be cut. Absent otherwise.
132
+ */
133
+ holdout?: boolean;
134
+ /**
135
+ * Transcripts from before the edit gate was removed: the gate kept a read pi guessed the agent would edit whole, and
136
+ * the model got the plain page. Like {@link holdout}, the sizes, steps and {@link original} describe the would-be
137
+ * cut, but `savedTokens` is 0. pi no longer writes it.
138
+ */
139
+ gated?: boolean;
140
+ /** Present only when shaping changed the text, or would have ({@link holdout}, {@link gated}). */
141
+ original?: SpotlightOriginal;
142
+ /** Present with {@link original} when Spotlight ranked the result's lines. */
143
+ request?: SpotlightRequestParams;
144
+ }
145
+ /**
146
+ * Tokens the shaped text saves against the plain result (negative: it costs more), or against the original on
147
+ * traces without {@link SpotlightDetails.plainTokens}.
148
+ */
149
+ export declare function spotlightSaving(spotlight: SpotlightDetails): number;
150
+ /** The trace a result's details carry, or undefined when the experiment did not shape it. */
151
+ export declare function spotlightDetails(details: unknown): SpotlightDetails | undefined;
152
+ /** The {@link SpotlightOriginal.heat} of per-line scores: each relative to the best, in ten steps. */
153
+ export declare function encodeHeat(scores: readonly (number | null)[]): string;
154
+ /** The heat of original line `i` (0-based) in [0, 1], or undefined when Spotlight never scored it. */
155
+ export declare function heatAt(heat: string, i: number): number | undefined;
156
+ /** {@link SpotlightOriginal.kept} of a per-line kept mask. */
157
+ export declare function keptRanges(kept: readonly boolean[]): [number, number][];
158
+ /** Whether original line `i` (0-based) scored hot: a heat digit of {@link HOT_DIGIT} or more. */
159
+ export declare function spotlightHot(heat: string, i: number): boolean;
160
+ /**
161
+ * The tone the sheet and the notice give original line `i` (0-based): why shaping showed it (`accent` score,
162
+ * `neutral` structure, `user` named, `info` context), `error` for a hidden line that scored hot; undefined for any
163
+ * other hidden line and for a line without a reason.
164
+ */
165
+ export declare function spotlightTone(original: SpotlightOriginal, i: number): TspTone | undefined;
166
+ /**
167
+ * The hover card of a changed result's notice: its heat as at most {@link NOTICE_BARS} bars (each the hottest of its
168
+ * lines, tinted by the most notable reason among them), then how many lines the model was shown, or of a held-out
169
+ * result would have been.
170
+ */
171
+ export declare function spotlightNoticeCard(original: SpotlightOriginal, heldOut?: boolean): TspPropNode;
172
+ /**
173
+ * The notice row under one tool card (role `zeta.tool.spotlight`, key `spotlight:<toolCallId>`): muted for a
174
+ * passthrough (its star alone, named by its tooltip) and for a held-out result, accent for a changed result
175
+ * ({@link noticeSpans}). One with an original (changed or held out) has a hover card charting its heat
176
+ * ({@link spotlightNoticeCard}) and a click that opens its sheet through the host's transcript actions. A native
177
+ * transcript block of its own, placed right after its card ({@link Component.nativeTrailers}), so it shows while the
178
+ * card is collapsed; nothing in the terminal rows.
179
+ */
180
+ export declare class SpotlightNotice implements Component {
181
+ #private;
182
+ constructor(toolCallId: string, spotlight: SpotlightDetails, reduced: string);
183
+ update(spotlight: SpotlightDetails, reduced: string): void;
184
+ /** Hidden with its card (tool activity hidden). */
185
+ setHidden(hidden: boolean): void;
186
+ describe(): NativeNode;
187
+ /** Never mounted in the terminal rows. */
188
+ render(): readonly string[];
189
+ invalidate(): void;
190
+ handleNativeEvent(event: NativeUiEvent): void;
191
+ }
192
+ /** The notices of one transcript block's calls, in the order the calls first reported a trace. */
193
+ export declare class SpotlightNotices {
194
+ #private;
195
+ /** Records call `toolCallId`'s final result; true when a notice appeared or went. */
196
+ set(toolCallId: string, details: unknown, reduced: string): boolean;
197
+ setHidden(hidden: boolean): void;
198
+ /**
199
+ * The notice blocks, the same array while none came or went; `shown` drops the notices of calls a
200
+ * transcript presenter hides (a fresh array then).
201
+ */
202
+ list(shown?: (toolCallId: string) => boolean): readonly Component[];
203
+ }
@@ -11,11 +11,18 @@ export interface ToolExecutionUi {
11
11
  requestComponentRender(component: Component): void;
12
12
  resetDisplay(): void;
13
13
  imageBudget?: TUI["imageBudget"];
14
+ showOverlay?: TUI["showOverlay"];
15
+ setFocus?: TUI["setFocus"];
16
+ terminal?: {
17
+ readonly rows: number;
18
+ };
14
19
  }
15
20
  export interface ToolExecutionOptions {
16
21
  showImages?: boolean;
17
22
  /** Allow the name-keyed renderer registry only when the active tool is the built-in implementation. */
18
23
  useBuiltInRenderer?: boolean;
24
+ /** Ask the extension transcript presenters; false for a replayed transcript (overlays). Default: true. */
25
+ transcriptPresenters?: boolean;
19
26
  }
20
27
  /** A tool result or progress frame as a card shows it. */
21
28
  export interface ToolResultFrame {
@@ -59,21 +66,25 @@ export declare function isSettledJobFrame(details: unknown): boolean;
59
66
  * a cancelled one keeps the output it got to and seals the card as cancelled.
60
67
  */
61
68
  export declare function settleWithJobFrame(component: ToolExecutionHandle, frame: ToolResultFrame, toolCallId: string): void;
62
- /** Phase-locked spinner glyph index shared by every live tool block so parallel
63
- * spinners advance in lockstep instead of each tracking its own start time. */
64
- export declare function sharedSpinnerFrame(frameCount: number, now?: number): number;
65
69
  /** Stop the shared spinner ticker and drop every registered live block.
66
70
  * Called on interactive-mode teardown so a stray live block cannot keep the
67
- * process-wide 80ms interval alive past shutdown (lingering event-loop
71
+ * process-wide spinner timer alive past shutdown (lingering event-loop
68
72
  * handles pin the process; cf. `postmortem.quit`). Test files that assert on
69
73
  * ticker arming also use this to start from a clean slate. */
70
74
  export declare function stopSharedSpinnerTicker(): void;
75
+ /** Whether the shared spinner ticker has a tick armed. Test seam: other timers on a fake clock
76
+ * (collab relay heartbeats) make a raw timer count ambiguous. */
77
+ export declare function sharedSpinnerTickerArmed(): boolean;
71
78
  /**
72
79
  * Component that renders a tool call with its result (updateable)
73
80
  */
74
81
  export declare class ToolExecutionComponent extends Container {
75
82
  #private;
76
83
  constructor(toolName: string, args: unknown, options: ToolExecutionOptions | undefined, tool: AgentTool | undefined, ui: ToolExecutionUi, _cwd?: string, toolCallId?: string);
84
+ /** Handle exactly the shared native action vocabulary; inspector uses this same controller. */
85
+ shellVizAction(action: string): void;
86
+ /** Open the focused inspector without intercepting composer input while it is closed. */
87
+ openShellVisualizer(): void;
77
88
  updateArgs(args: unknown, _toolCallId?: string): void;
78
89
  /**
79
90
  * Signal that args are complete (tool is about to execute).
@@ -146,6 +157,16 @@ export declare class ToolExecutionComponent extends Container {
146
157
  setExpanded(expanded: boolean): void;
147
158
  /** Mirrors the card collapsed or expanded in the terminal, so `Ctrl+O` and native toggles share one state. */
148
159
  handleNativeEvent(event: NativeUiEvent): void;
160
+ /**
161
+ * Blocks of their own right after the card: the result's Spotlight notice (visible while it is
162
+ * collapsed), and late diagnostics the card absorbed while a presenter compacts or hides it, so
163
+ * they stay visible.
164
+ */
165
+ nativeTrailers(): readonly Component[];
166
+ refreshTranscriptPresentation(ids?: ReadonlySet<string>): boolean;
167
+ /** The streamed call's id changed (or an empty one was filled in): presenters see, and refresh by, the new one. */
168
+ renameToolCallId(toolCallId: string): void;
169
+ isTranscriptBlockCompact(): boolean;
149
170
  /** Whether this call targets `filePath` (the late-diagnostics router matches with it). */
150
171
  matchesPath(filePath: string): boolean;
151
172
  /**
@@ -163,7 +184,7 @@ export declare class ToolExecutionComponent extends Container {
163
184
  * `elapsed` timer in the head and terminal-local collapse clamped to the
164
185
  * view's preview. Renderers without describe hooks (and extension tools
165
186
  * with only render hooks) get the generic card. Hidden tool activity stays
166
- * mounted so toggling it is one prop change.
187
+ * mounted so toggling it is one prop change; a presenter's answer applies on top.
167
188
  */
168
189
  describe(cx?: DescribeContext): NativeNode;
169
190
  /** Apply the transcript allocator's current viewport reservation. */
@@ -4,6 +4,7 @@
4
4
  * the interactive host registers the one handler that runs omp's existing
5
5
  * commands for them, so a click and the key binding take the same path.
6
6
  */
7
+ import type { SpotlightDetails } from "./spotlight.js";
7
8
  export type TranscriptAction =
8
9
  /** Retry the last failed turn (`app.retry`). */
9
10
  {
@@ -26,6 +27,16 @@ export type TranscriptAction =
26
27
  | {
27
28
  readonly act: "copy";
28
29
  readonly text: string;
30
+ }
31
+ /**
32
+ * Open the Spotlight sheet of a shaped tool result: its original beside `reduced`, the text the model saw (a
33
+ * held-out result's sheet shows the would-be text its trace's `shapedUrl` names instead).
34
+ */
35
+ | {
36
+ readonly act: "spotlight";
37
+ readonly toolCallId: string;
38
+ readonly spotlight: SpotlightDetails;
39
+ readonly reduced: string;
29
40
  };
30
41
  type Handler = (action: TranscriptAction) => void;
31
42
  /** Register (or clear, with `undefined`) the host's handler. */
@@ -79,8 +79,17 @@ export declare class TranscriptBrowser implements Component {
79
79
  handleScrollKey(data: string): boolean;
80
80
  scrollToTop(): void;
81
81
  scrollToBottom(): void;
82
+ /** Whether the view shows the first body row. */
83
+ get atTop(): boolean;
84
+ /** One past the last logical body row in view. */
85
+ get visibleEnd(): number;
82
86
  /** Whether an anchor identity has successfully been applied to the viewport. */
83
87
  hasAnchored(id: string): boolean;
88
+ /**
89
+ * What to add to a body row of the last frame to get its logical body row, as
90
+ * {@link toContentPoint} maps it; it follows the scroll, so a content row keeps its sum.
91
+ */
92
+ get frameRowOffset(): number;
84
93
  /**
85
94
  * Translate a 0-based frame mouse point into the logical, scrolled body.
86
95
  * Returns undefined for borders, header/footer rows, and unpainted body rows.