@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
@@ -108,6 +108,19 @@ export interface ViewportClickRowTarget {
108
108
  * decides focusability and recency.
109
109
  */
110
110
  export declare function routeViewportClick(spans: readonly ViewportClickSpan[], index: number): string[];
111
+ /** An extension link label drawn on a mutable-viewport line: what a click or hint tag lands on. */
112
+ export interface ViewportLink {
113
+ readonly url: string;
114
+ /** Mutable-viewport line the label is drawn on. */
115
+ readonly row: number;
116
+ /** First cell of the label's part on that line. */
117
+ readonly start: number;
118
+ }
119
+ /**
120
+ * Called once when link-hint mode ends; `reason` is `"crowded"` when a row held more links than
121
+ * their tags could fit side by side, so no tags were drawn.
122
+ */
123
+ export type LinkHintsEnd = (reason?: "crowded") => void;
111
124
  /**
112
125
  * Reserved click-candidate id for the pinned HUD expander row. Checked before
113
126
  * any registry lookup: its `@…:…` charset cannot collide with generated agent
@@ -146,11 +159,35 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
146
159
  * are never in the viewport). Callers intersect with the live registry.
147
160
  */
148
161
  viewportClickCandidates(index: number): string[];
162
+ /**
163
+ * The extension-owned link label drawn at cell `col` of a mutable-viewport line, or `undefined`.
164
+ * Only links whose scheme an extension registered match; see `extensionLinkLabels`.
165
+ */
166
+ viewportLinkAt(index: number, col: number): ViewportLink | undefined;
149
167
  /**
150
168
  * Point the hover band at a click-candidate id (or clear it). Takes effect
151
169
  * on the next frame; callers repaint only when the target actually changes.
152
170
  */
153
171
  setHoveredClickId(id: string | undefined): void;
172
+ /** How many extension link labels the last frame drew; a label wrapped across rows counts once. */
173
+ viewportLinkCount(): number;
174
+ /**
175
+ * Enter keyboard link-hint mode: the next frame draws a tag over each extension link label it
176
+ * shows. `onEnd` runs once when the mode ends: a pick, a cancel, a key no tag starts with, a
177
+ * repaint that no longer draws the tagged labels where they were, or (`"crowded"`) a row with
178
+ * too many links for their tags to fit side by side.
179
+ */
180
+ startLinkHints(onEnd: LinkHintsEnd): void;
181
+ /** Whether link-hint mode is on. */
182
+ get linkHintsActive(): boolean;
183
+ /**
184
+ * Type one letter of a tag. Returns the link whose whole tag is now typed, `true` while the
185
+ * letters still lead to several tags, and `false` when none starts with them. The mode ends on
186
+ * a pick or a miss.
187
+ */
188
+ typeLinkHint(letter: string): ViewportLink | boolean;
189
+ /** Leave link-hint mode without picking a link. */
190
+ cancelLinkHints(): void;
154
191
  /** Acknowledges one accepted header, replay, or transcript batch. */
155
192
  acknowledgeHistory(id: number): void;
156
193
  /** Render the semantic transcript tail while the terminal borrows its resize buffer. */
@@ -183,6 +220,12 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
183
220
  setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;
184
221
  /** Update the canonical editor reference after InteractiveMode remounts a custom editor. */
185
222
  setEditor(editor: CustomEditor): void;
223
+ /**
224
+ * End the startup input hold once the app's handlers are wired: the TSP
225
+ * terminal sends the typing it kept, and the keys the TUI held replay
226
+ * ({@link TUI.releaseHeldInput}). Idempotent.
227
+ */
228
+ releaseHeldInput(): void;
186
229
  /**
187
230
  * Mount the session-aware status component into the slot below the editor,
188
231
  * retiring the startup status line; the caller installs the real top-border
@@ -1,13 +1,16 @@
1
1
  /** Shared assistant transcript construction and model-authored link caching. */
2
2
  import type { AssistantMessage, Model } from "@linxiraos/pi-ai";
3
3
  import type { ImageBudget } from "../components/image.js";
4
- import type { AssistantThinkingRenderer } from "../chat/extension-types.js";
4
+ import type { AssistantTextRenderer, AssistantThinkingRenderer } from "../chat/extension-types.js";
5
5
  import { AssistantMessageComponent } from "../chat/assistant-message.js";
6
+ import { ReplyWriteComponent } from "../chat/reply-write.js";
6
7
  /** Session display capabilities supplied unchanged by the interactive host. */
7
8
  export interface AssistantMessageSession {
8
9
  readonly model?: Model;
9
10
  readonly extensionRunner?: {
10
11
  getAssistantThinkingRenderers(): readonly AssistantThinkingRenderer[];
12
+ /** Empty while the setting that enables them is off; hosts predating it may omit it. */
13
+ getAssistantTextRenderers?(): readonly AssistantTextRenderer[];
11
14
  };
12
15
  }
13
16
  /** Host state required to construct and refresh assistant transcript segments. */
@@ -42,6 +45,10 @@ export declare function assistantMessageLinkTargets(message: AssistantMessage, t
42
45
  /**
43
46
  * Construct an {@link AssistantMessageComponent} wired to the live context's
44
47
  * thinking/image settings. `message` is omitted for the streaming placeholder
45
- * component and supplied when rendering a persisted turn.
48
+ * component and supplied when rendering a persisted turn. `contentOffset` is
49
+ * the index in the full reply of the first block of a segment drawn after a
50
+ * tool call, so extension text renderers see the reply's own block indexes.
46
51
  */
47
- export declare function createAssistantMessageComponent(ctx: AssistantMessageHost, message?: AssistantMessage, linkTargets?: ReadonlyMap<string, string>): AssistantMessageComponent;
52
+ export declare function createAssistantMessageComponent(ctx: AssistantMessageHost, message?: AssistantMessage, linkTargets?: ReadonlyMap<string, string>, contentOffset?: number): AssistantMessageComponent;
53
+ /** Construct a {@link ReplyWriteComponent} (an `out://` write) drawn like the context's assistant prose. */
54
+ export declare function createReplyWriteComponent(ctx: AssistantMessageHost): ReplyWriteComponent;
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Set the registered schemes (lowercase, without `:`). Bumps {@link extensionLinksVersion} on any
3
+ * change so cached markdown renders are redrawn.
4
+ */
5
+ export declare function setExtensionLinks(next: Iterable<string>): void;
6
+ /** Changes whenever the scheme set changes; part of the markdown render cache key. */
7
+ export declare function extensionLinksVersion(): number;
8
+ /**
9
+ * Whether activating a registered-scheme link (a click or a hint tag) reaches its extension: a
10
+ * scheme is registered and the terminal is plain.
11
+ */
12
+ export declare function extensionLinksRouted(): boolean;
13
+ /**
14
+ * Set by the interactive product: whether the user has a way to pick a link drawn now (a bound
15
+ * hint key, mouse clicks). `undefined` when nothing in this process can pick one.
16
+ */
17
+ export declare function setExtensionLinkPicking(provider: (() => boolean) | undefined): void;
18
+ /**
19
+ * Whether a registered-scheme link drawn now can be activated: links are routed and the product
20
+ * offers a way to pick them. Process-wide, so a UI-less extension runner (a subagent's, whose
21
+ * transcript the user may focus) answers like the interactive one.
22
+ */
23
+ export declare function extensionLinkClicksAvailable(): boolean;
24
+ /** The registered scheme `href` uses, or `undefined` for every other link. */
25
+ export declare function extensionLinkScheme(href: string): string | undefined;
26
+ /**
27
+ * Draw an extension link's label: dotted-underlined (plain underline where the terminal has no
28
+ * styled underlines, re-applied after any style reset inside it) and wrapped in the OSC 8 marker
29
+ * {@link extensionLinkLabels} reads back in a plain terminal; as given in Tern's native view. Never
30
+ * followed by a ` (url)` suffix. `key` tells apart links of one URL drawn near each other; it must
31
+ * not change between renders of the same text, or rows rendered twice stop matching.
32
+ */
33
+ export declare function formatExtensionLink(label: string, href: string, key: string): string;
34
+ /**
35
+ * Tags for `count` links in keyboard link-hint mode: single letters while they suffice, otherwise
36
+ * two letters each, so no tag is a prefix of another. At most the alphabet squared (676) are made;
37
+ * links past that stay untagged.
38
+ */
39
+ export declare function linkHintTags(count: number): string[];
40
+ /**
41
+ * `line` without omp's extension-link markers (the OSC 8 open and close around each label), for
42
+ * terminal output. Every other hyperlink is kept as is.
43
+ */
44
+ export declare function stripExtensionLinkMarkers(line: string): string;
45
+ /** One extension link label drawn on a rendered row (before {@link stripExtensionLinkMarkers}). */
46
+ export interface ExtensionLinkLabel {
47
+ readonly url: string;
48
+ /**
49
+ * The marker's params, unique to each drawn link and repeated on every row a wrapped label
50
+ * spans, so a row's parts of one label can be told from an adjacent label of the same URL.
51
+ */
52
+ readonly id: string;
53
+ /** First 0-based cell the label covers. */
54
+ readonly start: number;
55
+ /** Cell just past the label. */
56
+ readonly end: number;
57
+ /** Whether only blank cells follow the label on its row, so a wrapped label may go on below. */
58
+ readonly endsRow: boolean;
59
+ }
60
+ /**
61
+ * The extension link labels drawn on a rendered row, left to right. Only omp's own markers with a
62
+ * registered scheme match, so ordinary hyperlinks (even of a registered scheme) and rows drawn for
63
+ * a scheme that is no longer registered never do.
64
+ */
65
+ export declare function extensionLinkLabels(line: string): ExtensionLinkLabel[];
@@ -1,14 +1,31 @@
1
1
  import type { TspSpan } from "@linxiraos/pi-wire";
2
2
  import { type TerminalId } from "../terminal-capabilities.js";
3
+ export interface FileLinkConfig {
4
+ scheme?: string;
5
+ host?: string;
6
+ }
7
+ interface FileUriOptions {
8
+ line?: number;
9
+ col?: number;
10
+ /** Native image open actions need a local file URL rather than a desktop handler. */
11
+ local?: boolean;
12
+ }
13
+ /**
14
+ * Resolve the remote file-link configuration once at host startup. Passing an
15
+ * explicit object lets SDK hosts and tests configure links without changing the
16
+ * process environment; an empty object restores ordinary file links. An invalid
17
+ * scheme or host logs a warning and keeps ordinary links.
18
+ */
19
+ export declare function applyFileLinkSetting(config?: FileLinkConfig): void;
3
20
  /**
4
- * A `file:` URL for `filePath`, or `undefined` when Node cannot encode it.
21
+ * A file-link target for `filePath`, or `undefined` when Node cannot encode it.
5
22
  *
6
23
  * Node rejects a malformed UNC target (a UNC path escaped twice by its author,
7
24
  * e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
8
25
  * A stored session keeps whatever a tool call recorded, so a transcript must
9
26
  * render such a path without a link rather than throw while it rebuilds.
10
27
  */
11
- export declare function tryFileUri(filePath: string): string | undefined;
28
+ export declare function tryFileUri(filePath: string, opts?: FileUriOptions): string | undefined;
12
29
  /**
13
30
  * Build the OSC 8 target for a file path on `terminalId`.
14
31
  *
@@ -23,7 +40,8 @@ export declare function tryFileUri(filePath: string): string | undefined;
23
40
  * The VS Code family instead navigates the documented
24
41
  * `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
25
42
  * URI is right, with the location left in the visible text — terminals that
26
- * parse a `path:line:col` suffix resolve that on their own.
43
+ * parse a `path:line:col` suffix resolve that on their own. A configured custom
44
+ * handler takes precedence and receives optional `line`/`col` query parameters.
27
45
  *
28
46
  * Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
29
47
  * target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
@@ -85,9 +103,8 @@ export declare function urlLinkSpan(target: string, displayText: string, s?: str
85
103
  /** Whether native link spans and nodes may carry an `href`: everything but an explicit `off` policy. */
86
104
  export declare function isNativeLinkEnabled(): boolean;
87
105
  /**
88
- * A native link span to a filesystem path as a plain `file://` URI (the
89
- * terminal opens it through the system; the location stays in the visible
90
- * text). Honours an explicit `off` policy.
106
+ * A native link span to a filesystem path using the configured file-link
107
+ * target. Honours an explicit `off` policy.
91
108
  */
92
109
  export declare function fileLinkSpan(filePath: string, displayText: string, s?: string): TspSpan;
93
110
  /**
@@ -101,9 +118,10 @@ export declare function fileLinkSpan(filePath: string, displayText: string, s?:
101
118
  *
102
119
  * @param filePath - Filesystem path
103
120
  * @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)
104
- * @param opts - Optional line/col position appended as `?line=N&col=M` query params
121
+ * @param opts - Optional line/col position (custom handlers use query params; VS Code uses a path suffix)
105
122
  */
106
123
  export declare function fileHyperlink(filePath: string, displayText: string, opts?: {
107
124
  line?: number;
108
125
  col?: number;
109
126
  }): string;
127
+ export {};
@@ -2,6 +2,7 @@
2
2
  * Public exports for shared TUI components.
3
3
  */
4
4
  export * from "./code-cell.js";
5
+ export * from "./extension-links.js";
5
6
  export * from "./file-list.js";
6
7
  export * from "./hyperlink.js";
7
8
  export * from "./output-block.js";
@@ -1,7 +1,7 @@
1
1
  import type { SetupScene } from "./types.js";
2
2
  /**
3
3
  * Preview and persist the terminal glyph preset. Skipped once the Glyph
4
- * Protocol handshake confirmed the terminal renders omp's bundled icons: every
4
+ * Protocol handshake confirmed the terminal renders Zeta's bundled icons: every
5
5
  * row renders cleanly there, and the default `unicode` preset already upgrades
6
6
  * to nerd at runtime while staying safe on terminals without the protocol.
7
7
  */
@@ -1,3 +1,3 @@
1
- import type { SetupScene } from "./types.js";
1
+ import { type SetupScene } from "./types.js";
2
2
  /** Setup step that assigns one available model to the persisted default role. */
3
3
  export declare const modelSetupScene: SetupScene;
@@ -1,9 +1,10 @@
1
1
  import type { NativeNode } from "../../native/node.js";
2
2
  export declare const SETUP_OUTRO_MS = 1200;
3
3
  /**
4
- * Native outro: the shimmering mark, the saved confirmation, and an
5
- * indeterminate progress bar standing in for the timed sweep. A click sends
6
- * the `continue` action.
4
+ * Native outro, centered: the shimmering Zeta mark, "Setup saved", the
5
+ * default model now in effect (`model`, its display name, when there is
6
+ * one), and an indeterminate progress bar standing in for the timed sweep.
7
+ * A click sends the `continue` action.
7
8
  */
8
- export declare function describeSetupOutro(): NativeNode;
9
+ export declare function describeSetupOutro(model: string | undefined): NativeNode;
9
10
  export declare function renderSetupOutro(width: number, height: number, elapsedMs: number): string[];
@@ -1,10 +1,15 @@
1
1
  import { type SgrMouseEvent } from "../../mouse.js";
2
- import type { NativeNode } from "../../native/node.js";
3
- import type { SetupScene, SetupSceneController, SetupSceneHost } from "./types.js";
2
+ import type { DescribeContext, NativeNode } from "../../native/node.js";
3
+ import { type SetupScene, type SetupSceneController, type SetupSceneHost } from "./types.js";
4
4
  /**
5
5
  * "Sign in" scene: lets the user authenticate one or more model providers via
6
6
  * OAuth. It never auto-advances the wizard — the user may sign in to several
7
- * providers and then continue with Esc.
7
+ * providers and then leave the step with Esc.
8
+ *
9
+ * Picking is the provider selector (natively a setup sheet: Skip/Continue on
10
+ * Esc, Sign in on Enter); signing in is the app's {@link LoginDialogComponent},
11
+ * driven like `/login` drives it: natively its own sheet over the setup page,
12
+ * in the cell grid drawn in the wizard body in place of the selector.
8
13
  */
9
14
  export declare class SignInScene implements SetupSceneController {
10
15
  #private;
@@ -14,15 +19,15 @@ export declare class SignInScene implements SetupSceneController {
14
19
  dispose(): void;
15
20
  invalidate(): void;
16
21
  handleInput(data: string): void;
17
- /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
22
+ /** Forward mouse to the provider selector; the login dialog takes keys only. */
18
23
  routeMouse(event: SgrMouseEvent, line: number, col: number): void;
19
24
  render(width: number, maxLines?: number): readonly string[];
20
25
  /**
21
- * Picking: intro, the provider selector (describes itself) and the last
22
- * outcome. Signing in: a spinner heading, the login link (with the full
23
- * URL once, char-wrapped), any code prompt and the flow's progress lines.
26
+ * Signing in: the login dialog (its own sheet). Picking: the provider
27
+ * selector, which presents the setup sheet where the terminal draws
28
+ * pickers; elsewhere it is an inline card under the lead and the outcome.
24
29
  */
25
- describe(): NativeNode;
30
+ describe(cx: DescribeContext): NativeNode;
26
31
  }
27
32
  /** Onboarding scene for provider sign-in. */
28
33
  export declare const providersSetupScene: SetupScene;
@@ -42,7 +42,6 @@ export interface SetupHost extends SetupUiHost {
42
42
  saveColorBlindMode(enabled: boolean): void;
43
43
  saveTheme(mode: "dark" | "light", name: string): void;
44
44
  captureBrowserSession(request: OAuthBrowserSessionRequest, signal?: AbortSignal): Promise<string>;
45
- copyToClipboard(text: string): Promise<void>;
46
45
  openInBrowser(url: string): void;
47
46
  markComplete(version: number): Promise<void>;
48
47
  playWelcomeIntro(): void;
@@ -80,11 +79,27 @@ export interface SetupSceneController extends Component {
80
79
  */
81
80
  routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
82
81
  }
82
+ /**
83
+ * Role of the sheet (`picker` or `overlay`) an interactive scene presents in a
84
+ * TSP terminal. The terminal's setup stylesheet seats it under the wizard's
85
+ * brand and stepper instead of floating it over a dimmed page.
86
+ */
87
+ export declare const SETUP_SHEET_ROLE = "zeta.setup.sheet";
88
+ /** Surface role of the setup page (wizard and startup splash) in a TSP terminal. */
89
+ export declare const SETUP_SURFACE_ROLE = "zeta.app.setup";
83
90
  /** Versioned onboarding scene definition. */
84
91
  export interface SetupScene {
85
92
  id: string;
86
93
  title: string;
94
+ /** Short label for the wizard's stepper (`Sign in`, `Model`). */
95
+ step: string;
87
96
  minVersion: number;
97
+ /**
98
+ * Configures something only the cell-grid renderer draws (glyphs, composer
99
+ * shape, theme). A TSP terminal draws those itself, so the wizard skips the
100
+ * scene while a native surface is live.
101
+ */
102
+ ansiOnly?: boolean;
88
103
  shouldRun?(ctx: SetupHost): boolean | Promise<boolean>;
89
104
  mount(host: SetupSceneHost): SetupSceneController;
90
105
  }
@@ -1,4 +1,4 @@
1
- import type { SetupUiHost } from "./scenes/types.js";
1
+ import { type SetupUiHost } from "./scenes/types.js";
2
2
  /** Timing controls for the standalone startup animation. */
3
3
  export interface RunStartupSplashOptions {
4
4
  readonly durationMs?: number;
@@ -1,7 +1,9 @@
1
1
  import { type Component, type OverlayFocusOwner } from "../tui.js";
2
- import type { NativeNode, NativeUiEvent } from "../native/node.js";
2
+ import type { DescribeContext, NativeNode, NativeScreen, NativeUiEvent } from "../native/node.js";
3
3
  import type { SetupHost } from "./scenes/types.js";
4
- import type { SetupScene } from "./scenes/types.js";
4
+ import { type SetupScene } from "./scenes/types.js";
5
+ /** Whether `scene` is asked under the current renderer: a TSP surface draws `ansiOnly` settings itself. */
6
+ export declare function setupSceneApplies(scene: SetupScene): boolean;
5
7
  /** Fullscreen onboarding presentation with scene focus and mouse routing. */
6
8
  export declare class SetupWizardComponent implements Component, OverlayFocusOwner {
7
9
  #private;
@@ -14,12 +16,14 @@ export declare class SetupWizardComponent implements Component, OverlayFocusOwne
14
16
  ownsOverlayFocusTarget(component: Component): boolean;
15
17
  handleInput(data: string): void;
16
18
  render(width: number): readonly string[];
19
+ /** The wizard is a page of its own: a screen surface styled by {@link SETUP_SURFACE_ROLE}. */
20
+ describeScreen(_cx: DescribeContext): NativeScreen;
17
21
  /**
18
- * Fullscreen description: splash, the active scene inside the wizard
19
- * frame (brand header, step counter, title, footer hints), or the outro.
20
- * The splash→scene dissolve is a row effect with no native counterpart, so
21
- * a transition describes as the scene.
22
+ * Fullscreen description: splash, the active scene under the setup
23
+ * header (brand, stepper, Exit setup), or the outro. The splash→scene
24
+ * dissolve is a row effect with no native counterpart, so a transition
25
+ * describes as the scene.
22
26
  */
23
- describe(): NativeNode;
27
+ describe(cx: DescribeContext): NativeNode;
24
28
  handleNativeEvent(event: NativeUiEvent): void;
25
29
  }
@@ -21,5 +21,9 @@ export interface RunSetupWizardOptions {
21
21
  markComplete?: boolean;
22
22
  playWelcomeIntro?: boolean;
23
23
  }
24
- /** Own the fullscreen setup overlay until its scenes and outro finish. */
24
+ /**
25
+ * Own the fullscreen setup overlay until its scenes and outro finish. When
26
+ * none of `scenes` applies to the current renderer (a TSP surface skips
27
+ * `ansiOnly` ones) nothing is shown, but completion is still persisted.
28
+ */
25
29
  export declare function runSetupWizard(ctx: SetupHost, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;
@@ -114,7 +114,7 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
114
114
  setRecording(recording: boolean): void;
115
115
  /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
116
116
  setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
117
- /** Set the callback that presents the first pool-wide saved-reset expiry warning, or clear it with `undefined`. */
117
+ /** Set the callback that presents pool-wide saved-reset expiry warnings, or clear it with `undefined`. */
118
118
  setResetExpiryNoticeHandler(handler: ((notice: string) => void) | undefined): void;
119
119
  setHookStatus(key: string, text: string | undefined): void;
120
120
  watchBranch(onBranchChange: () => void): void;
@@ -98,6 +98,11 @@ export interface NonMessageTokenSource {
98
98
  readonly state?: {
99
99
  readonly tools?: readonly ContextTool[];
100
100
  };
101
+ /**
102
+ * Whether requests to `model` ship description-stripped tool specs because
103
+ * the catalog rides in the system prompt (`Agent.prunesToolDescriptions`).
104
+ */
105
+ prunesToolDescriptions?(model: Model | undefined): boolean;
101
106
  };
102
107
  readonly skills?: readonly ContextSkill[];
103
108
  /** Provider-facing, session-frozen descriptions when available. */
@@ -131,24 +136,41 @@ export interface ToolSchemaFragments {
131
136
  /** Why serialization stopped; the schema or examples after that point are missing from `fragments`. */
132
137
  readonly schemaError?: string;
133
138
  }
139
+ /** How {@link toolSchemaFragments} renders one tool definition. */
140
+ export interface ToolSchemaFragmentOptions {
141
+ /** Also return `display`: the same fragments with the schema JSON indented by this many spaces. */
142
+ displayIndent?: number;
143
+ /**
144
+ * Mirror `normalizeTools({ pruneDescriptions: true })`: the wire spec is the
145
+ * name plus the description-stripped schema, with no description or examples.
146
+ */
147
+ pruneDescriptions?: boolean;
148
+ }
134
149
  /**
135
150
  * Provider-visible text of one tool definition. `displayIndent` additionally
136
151
  * returns `display`, the same fragments with the schema JSON indented, from
137
152
  * the same schema conversion.
138
153
  */
139
- export declare function toolSchemaFragments(tool: ContextTool, displayIndent?: number): ToolSchemaFragments;
154
+ export declare function toolSchemaFragments(tool: ContextTool, options?: ToolSchemaFragmentOptions): ToolSchemaFragments;
155
+ /** Inputs that select which tool-schema estimate applies, beyond the roster and tokenizer. */
156
+ export interface ToolSchemaEstimateOptions {
157
+ /** Caller settings/source revision; a change invalidates the cached estimate. */
158
+ sourceRevision?: number;
159
+ /** Count the description-stripped specs sent when the catalog rides in the system prompt. */
160
+ pruneDescriptions?: boolean;
161
+ }
140
162
  /**
141
163
  * Estimate provider-visible tool-schema tokens.
142
164
  *
143
165
  * Results are cached by roster-array identity, tokenizer identity, the
144
- * caller-supplied settings/source revision, and the roster's explicit dynamic
145
- * metadata revision. Callers whose descriptions or schemas are live getters
146
- * must either advance `sourceRevision` or call
166
+ * caller-supplied settings/source revision, the prune mode, and the roster's
167
+ * explicit dynamic metadata revision. Callers whose descriptions or schemas are
168
+ * live getters must either advance `sourceRevision` or call
147
169
  * {@link invalidateToolSchemaMetadata} when those inputs change.
148
170
  */
149
- export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, sourceRevision?: number): number;
171
+ export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, options?: ToolSchemaEstimateOptions): number;
150
172
  /** Count schemas carried on every request, excluding server-side deferred catalogs. */
151
- export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, sourceRevision?: number): number;
173
+ export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, options?: ToolSchemaEstimateOptions): number;
152
174
  export declare function computeNonMessageTokens(session: NonMessageTokenSource, tokenizer: Tokenizer, sourceRevision?: number): number;
153
175
  /**
154
176
  * Shared helper for the four non-message token totals used by
@@ -132,8 +132,12 @@ export interface StatusLineHost<TSession extends StatusLineSession = StatusLineS
132
132
  calculateTokensPerSecond(messages: readonly AgentMessage[], isStreaming: boolean): number | null;
133
133
  limitMatchesActiveAccount(report: UsageReport, limit: UsageLimit, identity: StatusAccountIdentity): boolean;
134
134
  classifyResetExpiry?(report: UsageReport, nowMs: number): StatusResetExpiry | undefined;
135
- /** One-line warning for saved resets anywhere in the pool that expire within 24 hours. */
136
- resetExpiryNotice?(reports: readonly UsageReport[], nowMs: number): string | undefined;
135
+ /**
136
+ * One-line warning for saved resets anywhere in the pool that are about to expire.
137
+ * The host owns deduplication: a returned warning counts as shown, so each saved
138
+ * reset is warned about once, not once per refresh or conversation.
139
+ */
140
+ resetExpiryNotice?(session: TSession, reports: readonly UsageReport[], nowMs: number): string | undefined;
137
141
  computeCompactionBoundaries(session: TSession, contextWindow: number, model?: Model): CompactionBoundaries | null;
138
142
  }
139
143
  export interface FooterHost {
@@ -114,29 +114,6 @@ export declare function stopThemeWatcher(): void;
114
114
  * Used by HTML export to generate CSS custom properties.
115
115
  */
116
116
  export declare function getResolvedThemeColors(themeName?: string): Promise<Record<string, string>>;
117
- /** One appearance variant of {@link NativeThemePalette}: token name → `#rrggbb`. */
118
- export type NativeThemeVariant = Record<string, string>;
119
- /** omp's resolved theme for a Tern Surface Protocol terminal (the `t` verb body minus `sf`). */
120
- export interface NativeThemePalette {
121
- dark?: NativeThemeVariant;
122
- light?: NativeThemeVariant;
123
- name: {
124
- dark?: string;
125
- light?: string;
126
- };
127
- }
128
- /**
129
- * Cheap identity of everything {@link getNativeThemePalette} depends on;
130
- * recompute the palette only when it changes.
131
- */
132
- export declare function getNativeThemePaletteKey(): string;
133
- /**
134
- * omp's theme for a native surface: with auto theme, the configured dark and
135
- * light themes; otherwise (or while the theme selector previews one) the
136
- * active theme under its own appearance only. Themes without a loadable
137
- * definition (in-memory instances) contribute nothing.
138
- */
139
- export declare function getNativeThemePalette(): NativeThemePalette;
140
117
  /**
141
118
  * Check if a theme is a "light" theme by analyzing its status-line background
142
119
  * luminance. Loads theme JSON synchronously (built-in or custom file on disk)
@@ -6,6 +6,12 @@ import type { Theme } from "../theme/theme.js";
6
6
  export interface BashInteractiveTerminalBackend {
7
7
  resize(columns: number, rows: number): void;
8
8
  }
9
+ /**
10
+ * Translates a TUI key event into the bytes a terminal would send to a PTY
11
+ * child; key releases encode to "". Shared by the agent `pty` console and
12
+ * `!` commands (`BashExecutionComponent.encodePtyInput`).
13
+ */
14
+ export declare function normalizeInputForPty(data: string, applicationCursorKeysMode: boolean): string;
9
15
  /** Interactive terminal overlay driven by an external PTY controller. */
10
16
  export declare class BashInteractiveOverlayComponent implements Component {
11
17
  #private;
@@ -24,6 +24,8 @@ export interface BashToolDetails {
24
24
  exitCode?: number;
25
25
  /** True when the command was killed by its timeout deadline (not a failure). */
26
26
  timedOut?: boolean;
27
+ /** Text the command wrote to `out://`, oldest first; transcripts draw each as a reply after the call. */
28
+ replies?: string[];
27
29
  /** Live ACP update only; completed results refer to released terminals. */
28
30
  terminalId?: string;
29
31
  service?: {
@@ -22,10 +22,12 @@ export interface DefaultToolRenderInput {
22
22
  export declare function formatDefaultToolExecution(input: DefaultToolRenderInput, contentWidth: number, uiTheme: Theme): string;
23
23
  /**
24
24
  * TSP view of the generic fallback card: the tool label with a one-line args
25
- * summary as the head target; the result as a JSON tree or raw `ansi` output.
26
- * The complete output goes over the wire — the card-level disclosure clamp the
27
- * terminal applies is the only bound, so an expanded card keeps every row. JSON
28
- * the tree's depth, node or scalar caps would cut keeps the raw path instead.
25
+ * summary as the head target; the result as JSON (the host's `json` viewer,
26
+ * else a JSON tree) or raw `ansi` output. The complete output goes over the
27
+ * wire — the card-level disclosure clamp the terminal applies is the only
28
+ * bound, so an expanded card keeps every row. The `json` viewer never cuts;
29
+ * JSON the fallback tree's depth, node or scalar caps would cut keeps the raw
30
+ * path instead.
29
31
  */
30
32
  export declare function describeDefaultToolExecution(input: DefaultToolRenderInput): NativeToolView;
31
33
  /** Render the generic fallback as the state-tinted card used by direct custom tools. */
@@ -25,6 +25,12 @@ export interface IrcMessage {
25
25
  * the broadcaster, mostly to say the message was not for it.
26
26
  */
27
27
  broadcast?: boolean;
28
+ /**
29
+ * Interim acknowledgement or progress on something the recipient asked
30
+ * (`agent://<id>?progress`): it neither answers that request nor asks one,
31
+ * so the recipient's `wait` keeps waiting for the actual reply.
32
+ */
33
+ progress?: boolean;
28
34
  }
29
35
  /** Delivery outcome for one peer recipient. */
30
36
  export interface IrcDeliveryReceipt {
@@ -12,6 +12,8 @@ export declare const JSON_TREE_MAX_LINES_EXPANDED = 200;
12
12
  export declare const JSON_TREE_SCALAR_LEN_COLLAPSED = 60;
13
13
  /** Maximum expanded JSON scalar width. */
14
14
  export declare const JSON_TREE_SCALAR_LEN_EXPANDED = 2000;
15
+ /** Characters a container's one-line form may take before a JSON tree lists its entries instead. */
16
+ export declare const JSON_TREE_INLINE_LEN = 60;
15
17
  /** Sanitization, string summary, and budgeting policy for inline JSON. */
16
18
  export interface InlineFormatOptions {
17
19
  sanitizeText?: (text: string) => string;
@@ -46,7 +48,8 @@ export interface JsonTreeRenderOptions {
46
48
  rootConnectors?: "hooked" | "siblings";
47
49
  }
48
50
  /**
49
- * Render a JSON value as bounded tree lines. The positional form remains the
51
+ * Render a JSON value as bounded tree lines, containers that fit
52
+ * {@link JSON_TREE_INLINE_LEN} on one row. The positional form remains the
50
53
  * public tool-renderer contract; the options form exposes sanitization and root
51
54
  * connector policy for specialized adapters such as nested task output.
52
55
  */
@@ -74,8 +77,24 @@ export interface JsonTreeDescribeOptions {
74
77
  onTruncated?: () => void;
75
78
  }
76
79
  /**
77
- * TSP `tree` of a JSON value: containers become expandable nodes labelled with
78
- * their key and size, scalars become `key: value` leaves styled by type.
79
- * Bounded by depth, node count and scalar length; no width math.
80
+ * TSP `tree` of a JSON value: containers that fit {@link JSON_TREE_INLINE_LEN}
81
+ * become `key: [1, "a"]` leaves, larger ones expandable nodes labelled with
82
+ * their key and size, scalars `key: value` leaves styled by type. Bounded by
83
+ * depth, node count and scalar length; no width math.
80
84
  */
81
85
  export declare function describeJsonTree(value: unknown, options?: JsonTreeDescribeOptions): NativeNode;
86
+ /** Options of {@link describeJsonValue}: the `json` node's own, plus the fallback tree's. */
87
+ export interface JsonValueDescribeOptions extends JsonTreeDescribeOptions {
88
+ /** The host draws the `json` kind (`cx.supports("json")`). */
89
+ native?: boolean;
90
+ /** `json` node: container levels expanded below the top-level entries (default 0). */
91
+ open?: number;
92
+ }
93
+ /**
94
+ * A JSON value for a TSP host: the terminal's own `json` viewer when it draws
95
+ * the kind, which folds and previews containers itself and never cuts (so
96
+ * `onTruncated` never fires), else {@link describeJsonTree} with the same
97
+ * options. Root keys the tree would hide are left out of the sent value too;
98
+ * strings are sanitized like the tree's labels.
99
+ */
100
+ export declare function describeJsonValue(value: unknown, options?: JsonValueDescribeOptions): NativeNode;
@@ -31,6 +31,8 @@ export interface FileDiagnosticsResult {
31
31
  summary: string;
32
32
  /** Whether there are any errors (severity 1) */
33
33
  errored: boolean;
34
+ /** Servers that sent no fresh report in time: the file is unverified for them, not clean. */
35
+ unreported?: string[];
34
36
  /** Whether the file was formatted */
35
37
  formatter?: FileFormatResult;
36
38
  }