@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.
- package/CHANGELOG.md +194 -195
- package/README.md +34 -34
- package/dist/types/app-keybindings.d.ts +15 -0
- package/dist/types/apps/session-picker.d.ts +5 -0
- package/dist/types/charts/chart-plan.d.ts +9 -7
- package/dist/types/chat/assistant-message.d.ts +15 -3
- package/dist/types/chat/bash-execution.d.ts +2 -0
- package/dist/types/chat/display-preferences.d.ts +2 -0
- package/dist/types/chat/extension-types.d.ts +31 -0
- package/dist/types/chat/reply-write.d.ts +48 -0
- package/dist/types/chat/table-chart.d.ts +4 -3
- package/dist/types/chat/tool-execution.d.ts +1 -2
- package/dist/types/chat/transcript-outline.d.ts +7 -0
- package/dist/types/chat/transcript-render-helpers.d.ts +2 -0
- package/dist/types/chrome/index.d.ts +1 -0
- package/dist/types/chrome/transcript-notice.d.ts +35 -0
- package/dist/types/chrome/transcript-status.d.ts +20 -8
- package/dist/types/components/editor.d.ts +8 -0
- package/dist/types/components/markdown.d.ts +7 -0
- package/dist/types/native/blobs.d.ts +2 -1
- package/dist/types/native/picker.d.ts +4 -4
- package/dist/types/overlays/annotation-overlay.d.ts +7 -1
- package/dist/types/overlays/annotation-types.d.ts +28 -0
- package/dist/types/overlays/login-dialog.d.ts +5 -1
- package/dist/types/overlays/model-browser.d.ts +10 -1
- package/dist/types/overlays/oauth-selector.d.ts +23 -0
- package/dist/types/overlays/plan-review-overlay.d.ts +2 -0
- package/dist/types/overlays/rewind-selector.d.ts +1 -1
- package/dist/types/overlays/session-selector.d.ts +22 -2
- package/dist/types/prompt/composer.d.ts +43 -0
- package/dist/types/prompt/interactive-context-helpers.d.ts +10 -3
- package/dist/types/render/extension-links.d.ts +65 -0
- package/dist/types/render/hyperlink.d.ts +25 -7
- package/dist/types/render/index.d.ts +1 -0
- package/dist/types/setup/scenes/glyph.d.ts +1 -1
- package/dist/types/setup/scenes/model.d.ts +1 -1
- package/dist/types/setup/scenes/outro.d.ts +5 -4
- package/dist/types/setup/scenes/sign-in.d.ts +13 -8
- package/dist/types/setup/scenes/types.d.ts +16 -1
- package/dist/types/setup/startup-splash.d.ts +1 -1
- package/dist/types/setup/wizard-overlay.d.ts +11 -7
- package/dist/types/setup/wizard.d.ts +5 -1
- package/dist/types/status-line/component.d.ts +1 -1
- package/dist/types/status-line/context-usage.d.ts +28 -6
- package/dist/types/status-line/host.d.ts +6 -2
- package/dist/types/theme/theme.d.ts +0 -23
- package/dist/types/tools/bash-interactive.d.ts +6 -0
- package/dist/types/tools/bash.d.ts +2 -0
- package/dist/types/tools/default-renderer.d.ts +6 -4
- package/dist/types/tools/irc.d.ts +6 -0
- package/dist/types/tools/json-tree.d.ts +23 -4
- package/dist/types/tools/lsp.d.ts +2 -0
- package/dist/types/tools/mcp.d.ts +6 -5
- package/dist/types/tools/native-view.d.ts +1 -1
- package/dist/types/tools/renderer.d.ts +2 -0
- package/dist/types/tools/streaming-output.d.ts +11 -0
- package/dist/types/tools/task.d.ts +9 -1
- package/dist/types/tools/url-scheme-host.d.ts +17 -0
- package/dist/types/tools/yield.d.ts +1 -1
- package/dist/types/tui.d.ts +7 -2
- package/package.json +10 -14
- package/src/app-keybindings.d.ts +15 -0
- package/src/app-keybindings.ts +15 -0
- package/src/apps/session-picker.ts +7 -0
- package/src/charts/chart-plan.d.ts +9 -7
- package/src/charts/chart-plan.ts +20 -50
- package/src/chat/advisor-message.ts +2 -0
- package/src/chat/assistant-message.d.ts +15 -3
- package/src/chat/assistant-message.ts +137 -19
- package/src/chat/background-tan-message.ts +4 -0
- package/src/chat/bash-execution.d.ts +2 -0
- package/src/chat/bash-execution.ts +6 -0
- package/src/chat/chat-transcript-builder.ts +58 -28
- package/src/chat/compaction-summary-message.ts +2 -1
- package/src/chat/display-preferences.d.ts +2 -0
- package/src/chat/display-preferences.ts +3 -0
- package/src/chat/extension-types.d.ts +31 -0
- package/src/chat/extension-types.ts +34 -0
- package/src/chat/reply-write.d.ts +48 -0
- package/src/chat/reply-write.ts +127 -0
- package/src/chat/table-chart.d.ts +4 -3
- package/src/chat/table-chart.ts +10 -4
- package/src/chat/tool-execution.d.ts +1 -2
- package/src/chat/tool-execution.ts +20 -13
- package/src/chat/transcript-outline.d.ts +7 -0
- package/src/chat/transcript-outline.ts +27 -0
- package/src/chat/transcript-render-helpers.d.ts +2 -0
- package/src/chat/transcript-render-helpers.ts +66 -24
- package/src/chrome/index.ts +1 -0
- package/src/chrome/transcript-notice.d.ts +35 -0
- package/src/chrome/transcript-notice.ts +83 -0
- package/src/chrome/transcript-status.d.ts +20 -8
- package/src/chrome/transcript-status.ts +29 -29
- package/src/components/editor.d.ts +8 -0
- package/src/components/editor.ts +10 -1
- package/src/components/markdown.d.ts +7 -0
- package/src/components/markdown.ts +116 -6
- package/src/hotkeys-markdown.ts +1 -0
- package/src/native/backend.ts +5 -66
- package/src/native/blobs.d.ts +2 -1
- package/src/native/blobs.ts +3 -2
- package/src/native/picker.d.ts +4 -4
- package/src/native/picker.ts +4 -4
- package/src/overlays/advisor-config.ts +1 -10
- package/src/overlays/annotation-overlay.ts +125 -37
- package/src/overlays/annotation-types.ts +24 -0
- package/src/overlays/hook-selector.ts +2 -2
- package/src/overlays/login-dialog.ts +31 -5
- package/src/overlays/mcp-add-wizard.ts +1 -1
- package/src/overlays/model-browser.ts +37 -0
- package/src/overlays/model-hub.ts +1 -7
- package/src/overlays/model-picker.ts +1 -10
- package/src/overlays/oauth-selector.ts +44 -6
- package/src/overlays/plan-review-overlay.ts +13 -2
- package/src/overlays/rewind-selector.ts +29 -12
- package/src/overlays/session-selector.ts +313 -42
- package/src/overlays/usage-dashboard.ts +5 -12
- package/src/prompt/composer.ts +216 -1
- package/src/prompt/custom-editor.ts +6 -1
- package/src/prompt/emoji-autocomplete.ts +0 -2
- package/src/prompt/interactive-context-helpers.ts +29 -4
- package/src/render/extension-links.d.ts +65 -0
- package/src/render/extension-links.ts +214 -0
- package/src/render/hyperlink.d.ts +25 -7
- package/src/render/hyperlink.ts +65 -9
- package/src/render/index.d.ts +1 -0
- package/src/render/index.ts +1 -0
- package/src/setup/scenes/composer.ts +2 -0
- package/src/setup/scenes/glyph.ts +3 -1
- package/src/setup/scenes/model.ts +192 -29
- package/src/setup/scenes/outro.ts +33 -15
- package/src/setup/scenes/sign-in.ts +196 -400
- package/src/setup/scenes/theme.ts +2 -0
- package/src/setup/scenes/types.ts +18 -1
- package/src/setup/startup-splash.ts +8 -7
- package/src/setup/wizard-overlay.ts +164 -35
- package/src/setup/wizard.ts +11 -2
- package/src/status-line/component.ts +4 -10
- package/src/status-line/context-usage.ts +72 -21
- package/src/status-line/host.ts +6 -2
- package/src/terminal.ts +24 -2
- package/src/theme/defaults.json +1 -0
- package/src/theme/loader.ts +1 -1
- package/src/theme/theme.d.ts +0 -23
- package/src/theme/theme.ts +2 -75
- package/src/tools/bash-interactive.d.ts +49 -0
- package/src/tools/bash-interactive.ts +6 -1
- package/src/tools/bash.d.ts +2 -0
- package/src/tools/bash.ts +2 -0
- package/src/tools/default-renderer.d.ts +6 -4
- package/src/tools/default-renderer.ts +9 -6
- package/src/tools/eval.ts +14 -4
- package/src/tools/irc.d.ts +6 -0
- package/src/tools/irc.ts +6 -0
- package/src/tools/job-widget.ts +13 -1
- package/src/tools/json-tree.d.ts +23 -4
- package/src/tools/json-tree.ts +132 -42
- package/src/tools/lsp.d.ts +2 -0
- package/src/tools/lsp.ts +36 -15
- package/src/tools/mcp.d.ts +6 -5
- package/src/tools/mcp.ts +20 -12
- package/src/tools/native-view.d.ts +1 -1
- package/src/tools/native-view.ts +1 -1
- package/src/tools/renderer.d.ts +2 -0
- package/src/tools/renderer.ts +2 -0
- package/src/tools/streaming-output.d.ts +11 -0
- package/src/tools/streaming-output.ts +41 -0
- package/src/tools/task.d.ts +9 -1
- package/src/tools/task.ts +59 -16
- package/src/tools/url-scheme-host.d.ts +17 -0
- package/src/tools/url-scheme-host.ts +21 -0
- package/src/tools/yield.d.ts +1 -1
- package/src/tools/yield.ts +18 -9
- package/src/tui.d.ts +7 -2
- package/src/tui.ts +43 -15
- package/dist/types/theme/defaults/index.d.ts +0 -10289
- package/src/theme/defaults/alabaster.json +0 -103
- package/src/theme/defaults/amethyst.json +0 -106
- package/src/theme/defaults/anthracite.json +0 -103
- package/src/theme/defaults/basalt.json +0 -101
- package/src/theme/defaults/birch.json +0 -105
- package/src/theme/defaults/dark-abyss.json +0 -101
- package/src/theme/defaults/dark-arctic.json +0 -114
- package/src/theme/defaults/dark-aurora.json +0 -105
- package/src/theme/defaults/dark-catppuccin.json +0 -117
- package/src/theme/defaults/dark-cavern.json +0 -101
- package/src/theme/defaults/dark-celestial.json +0 -116
- package/src/theme/defaults/dark-copper.json +0 -105
- package/src/theme/defaults/dark-cosmos.json +0 -100
- package/src/theme/defaults/dark-cyberpunk.json +0 -112
- package/src/theme/defaults/dark-dracula.json +0 -108
- package/src/theme/defaults/dark-eclipse.json +0 -101
- package/src/theme/defaults/dark-ember.json +0 -105
- package/src/theme/defaults/dark-equinox.json +0 -100
- package/src/theme/defaults/dark-forest.json +0 -106
- package/src/theme/defaults/dark-github.json +0 -115
- package/src/theme/defaults/dark-gruvbox.json +0 -122
- package/src/theme/defaults/dark-lavender.json +0 -105
- package/src/theme/defaults/dark-lunar.json +0 -99
- package/src/theme/defaults/dark-midnight.json +0 -105
- package/src/theme/defaults/dark-monochrome.json +0 -104
- package/src/theme/defaults/dark-monokai.json +0 -108
- package/src/theme/defaults/dark-nebula.json +0 -100
- package/src/theme/defaults/dark-neon-noir.json +0 -110
- package/src/theme/defaults/dark-nord.json +0 -108
- package/src/theme/defaults/dark-ocean.json +0 -111
- package/src/theme/defaults/dark-one.json +0 -110
- package/src/theme/defaults/dark-poimandres.json +0 -125
- package/src/theme/defaults/dark-rainforest.json +0 -101
- package/src/theme/defaults/dark-reef.json +0 -101
- package/src/theme/defaults/dark-retro.json +0 -102
- package/src/theme/defaults/dark-rose-pine.json +0 -106
- package/src/theme/defaults/dark-sakura.json +0 -105
- package/src/theme/defaults/dark-slate.json +0 -105
- package/src/theme/defaults/dark-solarized.json +0 -107
- package/src/theme/defaults/dark-solstice.json +0 -100
- package/src/theme/defaults/dark-starfall.json +0 -101
- package/src/theme/defaults/dark-sunset.json +0 -109
- package/src/theme/defaults/dark-swamp.json +0 -100
- package/src/theme/defaults/dark-synthwave.json +0 -113
- package/src/theme/defaults/dark-taiga.json +0 -101
- package/src/theme/defaults/dark-terminal.json +0 -105
- package/src/theme/defaults/dark-tokyo-night.json +0 -111
- package/src/theme/defaults/dark-tundra.json +0 -101
- package/src/theme/defaults/dark-twilight.json +0 -101
- package/src/theme/defaults/dark-volcanic.json +0 -101
- package/src/theme/defaults/graphite.json +0 -102
- package/src/theme/defaults/index.d.ts +0 -10289
- package/src/theme/defaults/index.ts +0 -203
- package/src/theme/defaults/light-arctic.json +0 -117
- package/src/theme/defaults/light-aurora-day.json +0 -101
- package/src/theme/defaults/light-canyon.json +0 -101
- package/src/theme/defaults/light-catppuccin.json +0 -116
- package/src/theme/defaults/light-cirrus.json +0 -100
- package/src/theme/defaults/light-coral.json +0 -105
- package/src/theme/defaults/light-cyberpunk.json +0 -106
- package/src/theme/defaults/light-dawn.json +0 -100
- package/src/theme/defaults/light-dunes.json +0 -101
- package/src/theme/defaults/light-eucalyptus.json +0 -105
- package/src/theme/defaults/light-forest.json +0 -110
- package/src/theme/defaults/light-frost.json +0 -105
- package/src/theme/defaults/light-github.json +0 -125
- package/src/theme/defaults/light-glacier.json +0 -101
- package/src/theme/defaults/light-gruvbox.json +0 -118
- package/src/theme/defaults/light-haze.json +0 -100
- package/src/theme/defaults/light-honeycomb.json +0 -105
- package/src/theme/defaults/light-lagoon.json +0 -101
- package/src/theme/defaults/light-lavender.json +0 -105
- package/src/theme/defaults/light-meadow.json +0 -101
- package/src/theme/defaults/light-mint.json +0 -105
- package/src/theme/defaults/light-monochrome.json +0 -111
- package/src/theme/defaults/light-ocean.json +0 -109
- package/src/theme/defaults/light-one.json +0 -109
- package/src/theme/defaults/light-opal.json +0 -101
- package/src/theme/defaults/light-orchard.json +0 -101
- package/src/theme/defaults/light-paper.json +0 -105
- package/src/theme/defaults/light-poimandres.json +0 -125
- package/src/theme/defaults/light-prism.json +0 -100
- package/src/theme/defaults/light-retro.json +0 -108
- package/src/theme/defaults/light-sand.json +0 -105
- package/src/theme/defaults/light-savanna.json +0 -101
- package/src/theme/defaults/light-solarized.json +0 -112
- package/src/theme/defaults/light-soleil.json +0 -100
- package/src/theme/defaults/light-sunset.json +0 -109
- package/src/theme/defaults/light-synthwave.json +0 -108
- package/src/theme/defaults/light-tokyo-night.json +0 -121
- package/src/theme/defaults/light-wetland.json +0 -101
- package/src/theme/defaults/light-zenith.json +0 -99
- package/src/theme/defaults/limestone.json +0 -104
- package/src/theme/defaults/mahogany.json +0 -107
- package/src/theme/defaults/marble.json +0 -103
- package/src/theme/defaults/obsidian.json +0 -101
- package/src/theme/defaults/onyx.json +0 -101
- package/src/theme/defaults/pearl.json +0 -103
- package/src/theme/defaults/porcelain.json +0 -101
- package/src/theme/defaults/quartz.json +0 -106
- package/src/theme/defaults/sandstone.json +0 -105
- 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
|
|
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
|
|
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
|
|
89
|
-
*
|
|
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
|
|
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 {};
|
|
@@ -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
|
|
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,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,
|
|
5
|
-
*
|
|
6
|
-
* the
|
|
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
|
|
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
|
|
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;
|
|
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
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
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,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
|
|
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
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
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
|
-
/**
|
|
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
|
|
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,
|
|
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
|
|
145
|
-
* metadata revision. Callers whose descriptions or schemas are
|
|
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,
|
|
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,
|
|
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
|
-
/**
|
|
136
|
-
|
|
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
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
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
|
|
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
|
|
78
|
-
*
|
|
79
|
-
*
|
|
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
|
}
|