@linxiraos/pi-tui 1.4.4 → 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 +208 -207
- package/README.md +34 -34
- package/dist/types/app-keybindings.d.ts +20 -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/context-map.d.ts +15 -0
- package/dist/types/chrome/context-presentation.d.ts +48 -0
- package/dist/types/chrome/context-view-model.d.ts +77 -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/image.d.ts +20 -0
- package/dist/types/components/loader.d.ts +1 -1
- package/dist/types/components/markdown.d.ts +7 -0
- package/dist/types/native/blobs.d.ts +11 -1
- package/dist/types/native/picker.d.ts +4 -4
- package/dist/types/overlays/advisor-config.d.ts +6 -0
- package/dist/types/overlays/agent-hub-projection.d.ts +3 -1
- package/dist/types/overlays/annotation-overlay.d.ts +7 -1
- package/dist/types/overlays/annotation-types.d.ts +28 -0
- package/dist/types/overlays/ask-dialog.d.ts +12 -3
- package/dist/types/overlays/btw-history-panel.d.ts +16 -2
- package/dist/types/overlays/btw-history.d.ts +7 -0
- package/dist/types/overlays/btw-panel.d.ts +2 -0
- package/dist/types/overlays/context-viewer-format.d.ts +42 -0
- package/dist/types/overlays/context-viewer-overview.d.ts +70 -0
- package/dist/types/overlays/context-viewer.d.ts +25 -0
- package/dist/types/overlays/hook-input.d.ts +1 -0
- package/dist/types/overlays/login-dialog.d.ts +5 -1
- package/dist/types/overlays/mcp-add-wizard.d.ts +2 -0
- package/dist/types/overlays/model-browser.d.ts +10 -1
- package/dist/types/overlays/oauth-selector.d.ts +23 -0
- package/dist/types/overlays/pause-screen.d.ts +13 -3
- 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/running-subagent-badge.d.ts +7 -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/prompt/macos-spelling.d.ts +2 -2
- package/dist/types/render/extension-links.d.ts +65 -0
- package/dist/types/render/hyperlink.d.ts +38 -7
- package/dist/types/render/index.d.ts +1 -0
- package/dist/types/render/output-pane.d.ts +1 -1
- package/dist/types/render/render-utils.d.ts +7 -1
- 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 +3 -3
- package/dist/types/status-line/context-usage.d.ts +42 -35
- package/dist/types/status-line/host.d.ts +6 -2
- package/dist/types/terminal-capabilities.d.ts +7 -0
- package/dist/types/theme/symbols.d.ts +1 -1
- package/dist/types/theme/theme.d.ts +0 -23
- package/dist/types/tools/ask.d.ts +4 -0
- 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/edit.d.ts +3 -1
- package/dist/types/tools/fetch.d.ts +1 -0
- package/dist/types/tools/github.d.ts +3 -0
- package/dist/types/tools/grouped-file-output.d.ts +2 -0
- 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 +7 -6
- package/dist/types/tools/native-view.d.ts +1 -1
- package/dist/types/tools/read.d.ts +3 -0
- 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/wait.d.ts +16 -2
- package/dist/types/tools/yield.d.ts +1 -1
- package/dist/types/tui.d.ts +9 -2
- package/dist/types/vim.d.ts +39 -0
- package/package.json +10 -14
- package/src/app-keybindings.d.ts +20 -0
- package/src/app-keybindings.ts +20 -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 +13 -1
- 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/read-tool-group.ts +1 -2
- package/src/chat/reply-write.d.ts +48 -0
- package/src/chat/reply-write.ts +127 -0
- package/src/chat/skill-message.ts +2 -6
- 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/context-map.ts +62 -0
- package/src/chrome/context-presentation.ts +26 -0
- package/src/chrome/context-view-model.ts +73 -0
- package/src/chrome/index.ts +1 -0
- package/src/chrome/transcript-container.ts +89 -59
- 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 +465 -14
- package/src/components/image.d.ts +20 -0
- package/src/components/image.ts +83 -18
- package/src/components/loader.d.ts +1 -1
- package/src/components/loader.ts +1 -1
- package/src/components/markdown.d.ts +7 -0
- package/src/components/markdown.ts +225 -13
- package/src/hotkeys-markdown.ts +2 -0
- package/src/native/backend.ts +5 -66
- package/src/native/blobs.d.ts +11 -1
- package/src/native/blobs.ts +5 -3
- package/src/native/picker.d.ts +4 -4
- package/src/native/picker.ts +4 -4
- package/src/overlays/advisor-config.ts +10 -12
- package/src/overlays/agent-hub-projection.d.ts +3 -1
- package/src/overlays/agent-hub-projection.ts +6 -5
- package/src/overlays/agent-hub.ts +51 -42
- package/src/overlays/annotation-overlay.ts +125 -37
- package/src/overlays/annotation-types.ts +24 -0
- package/src/overlays/ask-dialog.ts +125 -35
- package/src/overlays/btw-history-panel.ts +124 -12
- package/src/overlays/btw-history.ts +11 -0
- package/src/overlays/btw-panel.ts +8 -4
- package/src/overlays/context-viewer-format.ts +145 -0
- package/src/overlays/context-viewer-overview.ts +381 -0
- package/src/overlays/context-viewer.ts +728 -0
- package/src/overlays/hook-input.ts +2 -0
- package/src/overlays/hook-selector.ts +2 -2
- package/src/overlays/login-dialog.ts +31 -5
- package/src/overlays/mcp-add-wizard.ts +6 -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/pause-screen.ts +166 -33
- package/src/overlays/plan-review-overlay.ts +13 -2
- package/src/overlays/rewind-selector.ts +29 -12
- package/src/overlays/running-subagent-badge.ts +12 -1
- package/src/overlays/session-selector.ts +313 -42
- package/src/overlays/settings-defs.ts +1 -0
- package/src/overlays/usage-dashboard.ts +20 -14
- 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/prompt/macos-spelling.ts +24 -15
- package/src/render/extension-links.d.ts +65 -0
- package/src/render/extension-links.ts +214 -0
- package/src/render/hyperlink.d.ts +38 -7
- package/src/render/hyperlink.ts +102 -23
- package/src/render/index.d.ts +1 -0
- package/src/render/index.ts +1 -0
- package/src/render/output-pane.d.ts +1 -1
- package/src/render/output-pane.ts +60 -17
- package/src/render/render-utils.d.ts +7 -1
- package/src/render/render-utils.ts +11 -2
- 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 +194 -392
- 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 +10 -14
- package/src/status-line/context-usage.ts +122 -597
- package/src/status-line/host.ts +6 -2
- package/src/terminal-capabilities.d.ts +7 -0
- package/src/terminal-capabilities.ts +10 -0
- package/src/terminal.ts +24 -2
- package/src/theme/defaults.json +1 -0
- package/src/theme/loader.ts +1 -1
- package/src/theme/symbols.d.ts +1 -1
- package/src/theme/symbols.ts +16 -0
- package/src/theme/theme.d.ts +0 -23
- package/src/theme/theme.ts +2 -75
- package/src/tools/ask.d.ts +4 -0
- package/src/tools/ask.ts +4 -0
- package/src/tools/ast-grep.ts +3 -2
- 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 +7 -23
- package/src/tools/default-renderer.d.ts +6 -4
- package/src/tools/default-renderer.ts +9 -6
- package/src/tools/edit.d.ts +3 -1
- package/src/tools/edit.ts +8 -4
- package/src/tools/eval.ts +14 -4
- package/src/tools/fetch.d.ts +1 -0
- package/src/tools/fetch.ts +1 -0
- package/src/tools/find.ts +3 -10
- package/src/tools/github.d.ts +3 -0
- package/src/tools/github.ts +23 -3
- package/src/tools/glob.ts +4 -3
- package/src/tools/grep.ts +3 -4
- package/src/tools/grouped-file-output.d.ts +2 -0
- package/src/tools/grouped-file-output.ts +8 -2
- 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 +7 -6
- package/src/tools/mcp.ts +41 -15
- package/src/tools/native-view.d.ts +1 -1
- package/src/tools/native-view.ts +3 -3
- package/src/tools/read.d.ts +3 -0
- package/src/tools/read.ts +3 -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/vibe.ts +14 -3
- package/src/tools/wait.d.ts +16 -2
- package/src/tools/wait.ts +16 -2
- package/src/tools/yield.d.ts +1 -1
- package/src/tools/yield.ts +18 -9
- package/src/tui.d.ts +9 -2
- package/src/tui.ts +102 -34
- package/src/vim.d.ts +39 -0
- package/src/vim.ts +313 -22
- 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
package/README.md
CHANGED
|
@@ -28,7 +28,7 @@ const tui = new TUI(terminal);
|
|
|
28
28
|
tui.addChild(new Text("Welcome to my app!"));
|
|
29
29
|
|
|
30
30
|
const editor = new Editor(editorTheme);
|
|
31
|
-
editor.onSubmit =
|
|
31
|
+
editor.onSubmit = text => {
|
|
32
32
|
console.log("Submitted:", text);
|
|
33
33
|
tui.addChild(new Text(`You said: ${text}`));
|
|
34
34
|
};
|
|
@@ -106,12 +106,12 @@ interface Component {
|
|
|
106
106
|
}
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
| Method | Description
|
|
110
|
-
| ------------------------ |
|
|
109
|
+
| Method | Description |
|
|
110
|
+
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
111
111
|
| `render(width)` | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
|
|
112
|
-
| `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).
|
|
113
|
-
| `invalidate?()` | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.
|
|
114
|
-
| `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement.
|
|
112
|
+
| `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences). |
|
|
113
|
+
| `invalidate?()` | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call. |
|
|
114
|
+
| `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
|
|
115
115
|
|
|
116
116
|
## Built-in Components
|
|
117
117
|
|
|
@@ -119,20 +119,20 @@ interface Component {
|
|
|
119
119
|
|
|
120
120
|
Build screens from persistent components and update their data, selection, expansion, or size through setters. Layouts own child bounds and mouse-coordinate translation; controllers retain domain workflows and asynchronous operations. Propagate `invalidate()` after theme changes and `dispose()` when removing an owned component tree.
|
|
121
121
|
|
|
122
|
-
| Family
|
|
123
|
-
|
|
|
124
|
-
| Layout
|
|
125
|
-
| Panels
|
|
126
|
-
| Menus
|
|
127
|
-
| Forms
|
|
128
|
-
| Wizard steps | `WizardStep`
|
|
129
|
-
| Viewports
|
|
130
|
-
| Trees
|
|
131
|
-
| Disclosure
|
|
132
|
-
| Messages
|
|
133
|
-
| Tool output
|
|
134
|
-
| Transcripts
|
|
135
|
-
| Data
|
|
122
|
+
| Family | Components | Import |
|
|
123
|
+
| ------------ | ------------------------------------------------------------------------------- | ------------ |
|
|
124
|
+
| Layout | `Stack`, `Row`, `SplitPane` | package root |
|
|
125
|
+
| Panels | `OverlayPanel`, `PanelRows`, `PanelDivider` | `/chrome` |
|
|
126
|
+
| Menus | `SelectList`, `MenuSelection` | package root |
|
|
127
|
+
| Forms | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField` | package root |
|
|
128
|
+
| Wizard steps | `WizardStep` | package root |
|
|
129
|
+
| Viewports | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
|
|
130
|
+
| Trees | `TreeView` | package root |
|
|
131
|
+
| Disclosure | `Disclosure`, with lazy summary/detail children | package root |
|
|
132
|
+
| Messages | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent` | `/chrome` |
|
|
133
|
+
| Tool output | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane` | `/render` |
|
|
134
|
+
| Transcripts | `TranscriptBrowser` | package root |
|
|
135
|
+
| Data | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section` | package root |
|
|
136
136
|
|
|
137
137
|
```typescript
|
|
138
138
|
import { Disclosure, SplitPane, Text } from "@linxiraos/pi-tui";
|
|
@@ -176,10 +176,10 @@ Container that applies padding and background color to all children.
|
|
|
176
176
|
const box = new Box(
|
|
177
177
|
1, // paddingX (default: 1)
|
|
178
178
|
1, // paddingY (default: 1)
|
|
179
|
-
|
|
179
|
+
text => chalk.bgGray(text), // optional background function
|
|
180
180
|
);
|
|
181
181
|
box.addChild(new Text("Content"));
|
|
182
|
-
box.setBgFn(
|
|
182
|
+
box.setBgFn(text => chalk.bgBlue(text)); // Change background dynamically
|
|
183
183
|
```
|
|
184
184
|
|
|
185
185
|
### Text
|
|
@@ -191,10 +191,10 @@ const text = new Text(
|
|
|
191
191
|
"Hello World", // text content
|
|
192
192
|
1, // paddingX (default: 1)
|
|
193
193
|
1, // paddingY (default: 1)
|
|
194
|
-
|
|
194
|
+
text => chalk.bgGray(text), // optional background function
|
|
195
195
|
);
|
|
196
196
|
text.setText("Updated text");
|
|
197
|
-
text.setCustomBgFn(
|
|
197
|
+
text.setCustomBgFn(text => chalk.bgBlue(text));
|
|
198
198
|
```
|
|
199
199
|
|
|
200
200
|
### TruncatedText
|
|
@@ -215,7 +215,7 @@ Single-line text input with horizontal scrolling.
|
|
|
215
215
|
|
|
216
216
|
```typescript
|
|
217
217
|
const input = new Input();
|
|
218
|
-
input.onSubmit =
|
|
218
|
+
input.onSubmit = value => console.log(value);
|
|
219
219
|
input.setValue("initial");
|
|
220
220
|
input.getValue();
|
|
221
221
|
```
|
|
@@ -285,11 +285,11 @@ interface EditorTheme {
|
|
|
285
285
|
}
|
|
286
286
|
|
|
287
287
|
const editor = new Editor(theme);
|
|
288
|
-
editor.onSubmit =
|
|
289
|
-
editor.onChange =
|
|
288
|
+
editor.onSubmit = text => console.log(text);
|
|
289
|
+
editor.onChange = text => console.log("Changed:", text);
|
|
290
290
|
editor.disableSubmit = true; // Disable submit temporarily
|
|
291
291
|
editor.setAutocompleteProvider(provider);
|
|
292
|
-
editor.borderColor =
|
|
292
|
+
editor.borderColor = s => chalk.blue(s); // Change border dynamically
|
|
293
293
|
```
|
|
294
294
|
|
|
295
295
|
**Features:**
|
|
@@ -371,8 +371,8 @@ Animated loading spinner.
|
|
|
371
371
|
```typescript
|
|
372
372
|
const loader = new Loader(
|
|
373
373
|
tui, // TUI instance for render updates
|
|
374
|
-
|
|
375
|
-
|
|
374
|
+
s => chalk.cyan(s), // spinner color function
|
|
375
|
+
s => chalk.gray(s), // message color function
|
|
376
376
|
"Loading...", // message (default: "Loading...")
|
|
377
377
|
);
|
|
378
378
|
loader.start();
|
|
@@ -387,8 +387,8 @@ Extends Loader with Escape key handling and an AbortSignal for cancelling async
|
|
|
387
387
|
```typescript
|
|
388
388
|
const loader = new CancellableLoader(
|
|
389
389
|
tui, // TUI instance for render updates
|
|
390
|
-
|
|
391
|
-
|
|
390
|
+
s => chalk.cyan(s), // spinner color function
|
|
391
|
+
s => chalk.gray(s), // message color function
|
|
392
392
|
"Working...", // message
|
|
393
393
|
);
|
|
394
394
|
loader.onAbort = () => done(null); // Called when user presses Escape
|
|
@@ -430,9 +430,9 @@ const list = new SelectList(
|
|
|
430
430
|
theme, // SelectListTheme
|
|
431
431
|
);
|
|
432
432
|
|
|
433
|
-
list.onSelect =
|
|
433
|
+
list.onSelect = item => console.log("Selected:", item);
|
|
434
434
|
list.onCancel = () => console.log("Cancelled");
|
|
435
|
-
list.onSelectionChange =
|
|
435
|
+
list.onSelectionChange = item => console.log("Highlighted:", item);
|
|
436
436
|
list.setFilter("opt"); // Filter items
|
|
437
437
|
```
|
|
438
438
|
|
|
@@ -20,6 +20,7 @@ interface AppKeybindings {
|
|
|
20
20
|
"app.ask.hide": true;
|
|
21
21
|
"app.approval.approve": true;
|
|
22
22
|
"app.editor.external": true;
|
|
23
|
+
"app.local.open": true;
|
|
23
24
|
"app.message.followUp": true;
|
|
24
25
|
"app.retry": true;
|
|
25
26
|
"app.message.dequeue": true;
|
|
@@ -38,10 +39,13 @@ interface AppKeybindings {
|
|
|
38
39
|
"app.session.rename": true;
|
|
39
40
|
"app.session.delete": true;
|
|
40
41
|
"app.session.deleteNoninvasive": true;
|
|
42
|
+
"app.session.pin": true;
|
|
43
|
+
"app.session.unpin": true;
|
|
41
44
|
"app.tree.previousBranch": true;
|
|
42
45
|
"app.tree.nextBranch": true;
|
|
43
46
|
"app.plan.toggle": true;
|
|
44
47
|
"app.history.search": true;
|
|
48
|
+
"app.links.hint": true;
|
|
45
49
|
"app.stt.pushToTalk": true;
|
|
46
50
|
"app.stt.toggle": true;
|
|
47
51
|
"app.live.toggle": true;
|
|
@@ -252,6 +256,10 @@ export declare const KEYBINDINGS: {
|
|
|
252
256
|
readonly defaultKeys: "ctrl+g";
|
|
253
257
|
readonly description: "Open external editor";
|
|
254
258
|
};
|
|
259
|
+
readonly "app.local.open": {
|
|
260
|
+
readonly defaultKeys: "alt+g";
|
|
261
|
+
readonly description: "Open a local:// file in external editor";
|
|
262
|
+
};
|
|
255
263
|
readonly "app.message.followUp": {
|
|
256
264
|
readonly defaultKeys: ["ctrl+q", "ctrl+enter"];
|
|
257
265
|
readonly description: "Send follow-up message";
|
|
@@ -324,6 +332,14 @@ export declare const KEYBINDINGS: {
|
|
|
324
332
|
readonly defaultKeys: "ctrl+backspace";
|
|
325
333
|
readonly description: "Delete session (non-invasive)";
|
|
326
334
|
};
|
|
335
|
+
readonly "app.session.pin": {
|
|
336
|
+
readonly defaultKeys: "alt+k";
|
|
337
|
+
readonly description: "Pin the selected session in the resume picker";
|
|
338
|
+
};
|
|
339
|
+
readonly "app.session.unpin": {
|
|
340
|
+
readonly defaultKeys: "alt+shift+k";
|
|
341
|
+
readonly description: "Unpin the selected session in the resume picker";
|
|
342
|
+
};
|
|
327
343
|
readonly "app.tree.previousBranch": {
|
|
328
344
|
readonly defaultKeys: [];
|
|
329
345
|
readonly description: "Jump to the previous branch in /tree";
|
|
@@ -340,6 +356,10 @@ export declare const KEYBINDINGS: {
|
|
|
340
356
|
readonly defaultKeys: "ctrl+r";
|
|
341
357
|
readonly description: "Search history";
|
|
342
358
|
};
|
|
359
|
+
readonly "app.links.hint": {
|
|
360
|
+
readonly defaultKeys: "alt+o";
|
|
361
|
+
readonly description: "Pick an extension link on screen by its hint tag";
|
|
362
|
+
};
|
|
343
363
|
readonly "app.stt.pushToTalk": {
|
|
344
364
|
readonly defaultKeys: "space";
|
|
345
365
|
readonly description: "Hold to record speech-to-text";
|
|
@@ -5,6 +5,9 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
|
|
|
5
5
|
loadPinnedIds?(): Promise<ReadonlySet<string>>;
|
|
6
6
|
loadHistoryMatcher?(): SessionHistoryMatcher;
|
|
7
7
|
deleteSession?(session: T): Promise<boolean>;
|
|
8
|
+
/** Rename the session and resolve with the title as stored, or null when it did not happen. */
|
|
9
|
+
renameSession?(session: T, title: string): Promise<string | null>;
|
|
10
|
+
setSessionPinned?(session: T, pinned: boolean): Promise<void>;
|
|
8
11
|
loadAllSessions?(): Promise<T[]>;
|
|
9
12
|
/** Builds the three-level resume source for the standalone `--resume` tree. */
|
|
10
13
|
loadResumeSource?(deleteMode: "trash" | "permanent", workspacePath?: string): Promise<ResumeTreeSource | undefined>;
|
|
@@ -16,6 +19,8 @@ export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSe
|
|
|
16
19
|
scopeLabel?: string | false;
|
|
17
20
|
showCwd?: boolean;
|
|
18
21
|
allowDelete?: boolean;
|
|
22
|
+
/** Rename the selected session; resolve with the title as stored, or null when it did not happen. */
|
|
23
|
+
onRename?: (session: T, title: string) => Promise<string | null>;
|
|
19
24
|
allowGlobalScope?: boolean;
|
|
20
25
|
historySearch?: boolean;
|
|
21
26
|
pinnedIds?: ReadonlySet<string>;
|
|
@@ -419,9 +419,10 @@ export type ChartAnnotation = {
|
|
|
419
419
|
export declare function planChart(table: TableAnalysis): ChartPlan | undefined;
|
|
420
420
|
/**
|
|
421
421
|
* Whether a model should pick `table`'s chart (`tui.autoGraph: smart`):
|
|
422
|
-
* multi-series tables,
|
|
423
|
-
* `guess` plots (`Thread | State`, `Finding | Current`),
|
|
424
|
-
* tells a
|
|
422
|
+
* multi-series tables, tables whose rows may be named by a number the
|
|
423
|
+
* `guess` plots (`Thread | State`, `Finding | Current`), and any other chart
|
|
424
|
+
* the guess would draw — only meaning tells a measure from page references,
|
|
425
|
+
* step numbers or figures quoted in prose, which the judge charts as none.
|
|
425
426
|
*/
|
|
426
427
|
export declare function shouldJudge(table: TableAnalysis, guess: ChartPlan | undefined): boolean;
|
|
427
428
|
/** Measure columns before `guess`'s text label column: numbers that may only name their rows. */
|
|
@@ -446,10 +447,11 @@ export declare function tableTakeaways(table: TableAnalysis, plan: ChartPlan, co
|
|
|
446
447
|
*/
|
|
447
448
|
export declare function drawnNames(spec: ChartSpec): Set<string>;
|
|
448
449
|
/**
|
|
449
|
-
* The local guess at what `plan`'s rows and measures mean:
|
|
450
|
-
*
|
|
451
|
-
*
|
|
452
|
-
* `(current)` row names, and a status
|
|
450
|
+
* The local guess at what `plan`'s rows and measures mean: each measure's
|
|
451
|
+
* {@link Polarity} as far as its unit says ({@link dimPolarity}; what a name
|
|
452
|
+
* means — `Memory` as a capacity or a cost — is the judge's call), rivals from
|
|
453
|
+
* the label's header, focus from bolded or `(current)` row names, and a status
|
|
454
|
+
* column whose cells vary.
|
|
453
455
|
*/
|
|
454
456
|
export declare function guessMeaning(table: TableAnalysis, plan: ChartPlan): Pick<ChartPlan, "polarity" | "rowPolarity" | "rivals" | "focus" | "status">;
|
|
455
457
|
/** Whether `plan`'s rows may each be a metric of their own: a `change`, a transposed table, or mixed-unit columns. */
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { AssistantMessage, ImageContent } from "@linxiraos/pi-ai";
|
|
2
2
|
import { type Component, Container } from "../tui.js";
|
|
3
3
|
import { type ImageBudget } from "../components/image.js";
|
|
4
|
-
import type { AssistantThinkingRenderer } from "./extension-types.js";
|
|
4
|
+
import type { AssistantTextRenderer, AssistantTextRendering, AssistantThinkingRenderer } from "./extension-types.js";
|
|
5
5
|
import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
|
|
6
6
|
import { type CacheInvalidation } from "./cache-invalidation-marker.js";
|
|
7
7
|
import { type ServedModelMismatch } from "./served-model-marker.js";
|
|
@@ -38,7 +38,7 @@ export declare class AssistantMessageComponent extends Container {
|
|
|
38
38
|
* for lack of a target is re-rendered with its reaction stripped.
|
|
39
39
|
*/
|
|
40
40
|
pickReactionTarget(transcript: readonly Component[]): void;
|
|
41
|
-
constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean);
|
|
41
|
+
constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean, textRendering?: AssistantTextRendering);
|
|
42
42
|
/**
|
|
43
43
|
* Show or clear the trailing cache-invalidation divider. Set at `message_end`
|
|
44
44
|
* (live) or during rebuild, once the turn's usage is known and compared
|
|
@@ -87,7 +87,7 @@ export declare class AssistantMessageComponent extends Container {
|
|
|
87
87
|
*/
|
|
88
88
|
setExpanded(expanded: boolean): void;
|
|
89
89
|
isTranscriptBlockFinalized(): boolean;
|
|
90
|
-
/**
|
|
90
|
+
/** Hold image and figure rendering until the completed block can enter immutable scrollback. */
|
|
91
91
|
isTranscriptBlockPending(): boolean;
|
|
92
92
|
render(width: number): readonly string[];
|
|
93
93
|
/**
|
|
@@ -122,7 +122,19 @@ export declare class AssistantMessageComponent extends Container {
|
|
|
122
122
|
renderTranscriptBlockEmergencyRow(width: number): string | undefined;
|
|
123
123
|
getTranscriptBlockVersion(): number;
|
|
124
124
|
markTranscriptBlockFinalized(): void;
|
|
125
|
+
/**
|
|
126
|
+
* Swap the extension text renderers (the setting enabling them changed) and redraw with them.
|
|
127
|
+
* Enabling them also drops rows already published as stable, since a renderer may rewrite them;
|
|
128
|
+
* callers MUST pair this with a scrollback-clearing display reset, as for
|
|
129
|
+
* {@link resetTranscriptStableRows}.
|
|
130
|
+
*/
|
|
131
|
+
setTextRenderers(renderers: readonly AssistantTextRenderer[]): void;
|
|
125
132
|
applyRetryRecovery(retryRecovery: AssistantMessage["retryRecovery"]): void;
|
|
133
|
+
/**
|
|
134
|
+
* Draw the current message again when it is the reply sent at `timestamp`, re-running the
|
|
135
|
+
* extension text renderers; returns whether it was. The caller schedules the frame.
|
|
136
|
+
*/
|
|
137
|
+
rerenderMessage(timestamp: number): boolean;
|
|
126
138
|
messagePersistenceKey(): string | undefined;
|
|
127
139
|
/** Toggle rendering for assistant-native and tool-result images. */
|
|
128
140
|
setImagesVisible(visible: boolean): void;
|
|
@@ -37,6 +37,8 @@ export declare class BashExecutionComponent extends Container {
|
|
|
37
37
|
appendOutput(chunk: string): void;
|
|
38
38
|
/** Switch to PTY rendering and feed raw terminal bytes through the vterm replay. */
|
|
39
39
|
appendPtyChunk(chunk: string): void;
|
|
40
|
+
/** Bytes a terminal would send for a key event, honoring the command's cursor-key mode; "" for key releases. */
|
|
41
|
+
encodePtyInput(data: string): string;
|
|
40
42
|
setComplete(exitCode: number | undefined, cancelled: boolean, options?: {
|
|
41
43
|
output?: string;
|
|
42
44
|
truncation?: TruncationMeta;
|
|
@@ -6,6 +6,8 @@ export interface ChatTranscriptDisplayPreferences {
|
|
|
6
6
|
cacheMissMarker: boolean;
|
|
7
7
|
showTokenUsage: boolean;
|
|
8
8
|
showTurnTime: boolean;
|
|
9
|
+
/** Max rows a collapsed advisor card shows below its header; 0 = no cap. */
|
|
10
|
+
advisorCollapsedLines: number;
|
|
9
11
|
}
|
|
10
12
|
/** Current transcript display preferences. */
|
|
11
13
|
export declare const chatTranscriptDisplayPreferences: ChatTranscriptDisplayPreferences;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { AssistantMessage } from "@linxiraos/pi-ai";
|
|
1
2
|
import type { Component, TUI } from "../tui.js";
|
|
2
3
|
import type { Theme } from "../theme/theme.js";
|
|
3
4
|
import type { CustomMessage, HookMessage } from "./messages.js";
|
|
@@ -17,6 +18,36 @@ export interface AssistantThinkingRenderContext {
|
|
|
17
18
|
requestRender(): void;
|
|
18
19
|
}
|
|
19
20
|
export type AssistantThinkingRenderer = (context: AssistantThinkingRenderContext, theme: Theme) => Component | undefined;
|
|
21
|
+
export interface AssistantTextRenderContext {
|
|
22
|
+
/**
|
|
23
|
+
* The message being drawn; `message.timestamp` identifies the reply for `ctx.ui.rerenderMessage()`.
|
|
24
|
+
* After a tool call this is only the segment drawn there, so its `content` does not hold the whole reply.
|
|
25
|
+
* A deep copy: editing it, at any depth, cannot change the stored reply.
|
|
26
|
+
*/
|
|
27
|
+
message: AssistantMessage;
|
|
28
|
+
/**
|
|
29
|
+
* The text block's index in the full reply's `content`, also when the reply is drawn in segments
|
|
30
|
+
* around tool calls; not an index into `message.content` for a segment. It counts the content as
|
|
31
|
+
* currently stored: a transcript rebuild that drops tool calls left without a result shifts later
|
|
32
|
+
* blocks down, so do not persist it as a permanent key.
|
|
33
|
+
*/
|
|
34
|
+
contentIndex: number;
|
|
35
|
+
/** The block's markdown as drawn so far, after any earlier renderer. */
|
|
36
|
+
text: string;
|
|
37
|
+
/** True while the block may still grow; false for its final render, a block sealed at a tool call, and later redraws. */
|
|
38
|
+
streaming: boolean;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Display-only transform of one assistant text block: returns the markdown to draw, or `undefined`
|
|
42
|
+
* to draw `context.text` unchanged. The session, exports and model context keep the original text.
|
|
43
|
+
*/
|
|
44
|
+
export type AssistantTextRenderer = (context: AssistantTextRenderContext) => string | undefined;
|
|
45
|
+
/** Extension text renderers for one assistant component, and where its content starts in the full reply. */
|
|
46
|
+
export interface AssistantTextRendering {
|
|
47
|
+
renderers: readonly AssistantTextRenderer[];
|
|
48
|
+
/** Index in the full reply's `content` of this component's first block; a segment after a tool call starts past it. */
|
|
49
|
+
contentOffset: number;
|
|
50
|
+
}
|
|
20
51
|
export interface HookMessageRenderOptions {
|
|
21
52
|
/** Whether the view is expanded */
|
|
22
53
|
expanded: boolean;
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Replies: text the agent sends to a scheme whose writes are `reply`-scoped (`out://`)
|
|
3
|
+
* is its mid-turn message to the user, drawn as assistant prose so it can answer
|
|
4
|
+
* without ending its turn.
|
|
5
|
+
* - A `write` call to a reply URL draws as {@link ReplyWriteComponent}, streaming as the
|
|
6
|
+
* call's arguments arrive, instead of a tool card.
|
|
7
|
+
* - Text a tool's commands write there (`printf … > out://` in bash) arrives in the
|
|
8
|
+
* tool's result `details.replies` ({@link toolResultReplies}); transcripts draw each
|
|
9
|
+
* one as a prose block after the call ({@link replyDisplayMessage}).
|
|
10
|
+
*/
|
|
11
|
+
import type { AssistantMessage } from "@linxiraos/pi-ai";
|
|
12
|
+
import type { ImageBudget } from "../components/image.js";
|
|
13
|
+
import { AssistantMessageComponent } from "./assistant-message.js";
|
|
14
|
+
import type { ToolExecutionHandle, ToolResultFrame } from "./tool-execution.js";
|
|
15
|
+
/**
|
|
16
|
+
* Whether a `toolName` call writes to a reply URL. `undefined` while streamed args cannot tell yet:
|
|
17
|
+
* no path so far, or a path that could still grow into a reply URL (`ou`, `out:/`). Callers holding
|
|
18
|
+
* final args treat `undefined` as `false`.
|
|
19
|
+
*/
|
|
20
|
+
export declare function isReplyWrite(toolName: string, args: unknown): boolean | undefined;
|
|
21
|
+
/** Display options of a reply block; the rest of its presentation follows the assistant prose defaults. */
|
|
22
|
+
export interface ReplyWriteOptions {
|
|
23
|
+
/** Repaint request for figures and images that finish loading after a render. */
|
|
24
|
+
readonly requestRender?: () => void;
|
|
25
|
+
readonly imageBudget?: ImageBudget;
|
|
26
|
+
/** Resolved local destinations of Markdown links, as for assistant text. */
|
|
27
|
+
readonly linkTargets?: ReadonlyMap<string, string>;
|
|
28
|
+
}
|
|
29
|
+
/** Replies a tool result carries in `details.replies` (text its commands wrote to a reply URL), oldest first. */
|
|
30
|
+
export declare function toolResultReplies(details: unknown): readonly string[];
|
|
31
|
+
/** Assistant message drawing reply text. No provider turn backs it, so its identity fields stay empty. */
|
|
32
|
+
export declare function replyDisplayMessage(text: string, errorMessage?: string): AssistantMessage;
|
|
33
|
+
/**
|
|
34
|
+
* A reply write ({@link isReplyWrite}) drawn as assistant prose. The call's lifecycle arrives
|
|
35
|
+
* through {@link ToolExecutionHandle}: streamed args grow the text, final args settle it, and
|
|
36
|
+
* the result seals the block, a failure showing its error under the text. It is a reply, not
|
|
37
|
+
* tool activity, so hiding tool activity leaves it on screen.
|
|
38
|
+
*/
|
|
39
|
+
export declare class ReplyWriteComponent extends AssistantMessageComponent implements ToolExecutionHandle {
|
|
40
|
+
#private;
|
|
41
|
+
constructor(options?: ReplyWriteOptions);
|
|
42
|
+
updateArgs(args: unknown): void;
|
|
43
|
+
setArgsComplete(): void;
|
|
44
|
+
setExecutionStarted(): void;
|
|
45
|
+
updateResult(result: ToolResultFrame, isPartial?: boolean): void;
|
|
46
|
+
parkAsBackground(): void;
|
|
47
|
+
seal(): void;
|
|
48
|
+
}
|
|
@@ -19,10 +19,11 @@ export interface TableChartRequest {
|
|
|
19
19
|
readonly guess: ChartPlan;
|
|
20
20
|
}
|
|
21
21
|
/**
|
|
22
|
-
* Picks the chart for a
|
|
23
|
-
*
|
|
22
|
+
* Picks the chart for a table under `smart`: a plan, or `null` for no chart.
|
|
23
|
+
* A rejection falls back to the local guess; `undefined` (no judge to ask
|
|
24
|
+
* right now) keeps the guess at once, exactly as `always` would draw it.
|
|
24
25
|
*/
|
|
25
|
-
export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null
|
|
26
|
+
export type TableChartPlanner = (request: TableChartRequest) => Promise<ChartPlan | null> | undefined;
|
|
26
27
|
/**
|
|
27
28
|
* The chart under a table: its SVG, colored with figure tokens (`var(--accent)`, …)
|
|
28
29
|
* still to resolve; none; or a smart pick on its way (the promise settles once the cache holds it).
|
|
@@ -35,7 +35,6 @@ export interface ToolExecutionHandle extends Component {
|
|
|
35
35
|
setArgsComplete(toolCallId?: string): void;
|
|
36
36
|
setExecutionStarted(toolCallId?: string): void;
|
|
37
37
|
setExpanded(expanded: boolean): void;
|
|
38
|
-
setToolActivityVisible(visible: boolean): void;
|
|
39
38
|
/** Mark the call parked: it returned, but stays tracked for async job frames. */
|
|
40
39
|
parkAsBackground(): void;
|
|
41
40
|
/** Seal the block as final history and stop its animations. */
|
|
@@ -102,7 +101,7 @@ export declare class ToolExecutionComponent extends Container {
|
|
|
102
101
|
* component-scoped so the TUI reuses every other root subtree (issue #4377).
|
|
103
102
|
*/
|
|
104
103
|
tickSpinner(frame: number): void;
|
|
105
|
-
/**
|
|
104
|
+
/** Hold visible results until their figures and Kitty images are ready for immutable scrollback. */
|
|
106
105
|
isTranscriptBlockPending(): boolean;
|
|
107
106
|
/**
|
|
108
107
|
* Whether this block is ready to retire as immutable history. Partial
|
|
@@ -9,6 +9,7 @@ import { type TranscriptEntryLike as TranscriptEntry } from "./transcript-entry.
|
|
|
9
9
|
import type { SessionMessageEntryLike as SessionMessageEntry } from "./transcript-entry.js";
|
|
10
10
|
import { type ThemeColor } from "../theme/index.js";
|
|
11
11
|
import type { ChatTranscriptBuilder } from "./chat-transcript-builder.js";
|
|
12
|
+
import type { DescribeContext } from "../native/node.js";
|
|
12
13
|
/** One selectable transcript item: a message entry plus its rendered block range. */
|
|
13
14
|
export interface OutlineTarget {
|
|
14
15
|
/** Entry the selection resolves to; extended over trailing componentless tool results. */
|
|
@@ -63,6 +64,12 @@ export declare class OutlineRowCache {
|
|
|
63
64
|
export declare function appendOutlineEntries(builder: ChatTranscriptBuilder, entries: TranscriptEntry[]): OutlineTarget[];
|
|
64
65
|
/** Per-target "renders at least one non-blank row" flags at the given rows. */
|
|
65
66
|
export declare function outlineVisibility(childRows: readonly (readonly string[])[], targets: readonly OutlineTarget[]): boolean[];
|
|
67
|
+
/**
|
|
68
|
+
* Per-target "describes something that shows" flags: {@link outlineVisibility}
|
|
69
|
+
* for a TSP page, where blocks describe nodes instead of rendering rows. An
|
|
70
|
+
* empty `col`/`row` (an interrupted turn with no output) shows nothing.
|
|
71
|
+
*/
|
|
72
|
+
export declare function describedVisibility(blocks: readonly Component[], targets: readonly OutlineTarget[], cx: DescribeContext): boolean[];
|
|
66
73
|
/** Dotted horizontal rule with rounded corners, spanning the outline width. */
|
|
67
74
|
export declare function outlineRule(left: string, right: string, innerWidth: number, color?: ThemeColor, caption?: string): string;
|
|
68
75
|
/** Wrap pre-rendered rows in the dotted outline (rules above/below, `┆` sides). */
|
|
@@ -55,6 +55,8 @@ export declare function assistantHasVisibleContent(message: AssistantAgentMessag
|
|
|
55
55
|
export declare function splitAssistantMessageToolTimeline(message: AssistantAgentMessage): {
|
|
56
56
|
beforeTools: AssistantAgentMessage;
|
|
57
57
|
afterToolCalls: ReadonlyMap<string, AssistantAgentMessage>;
|
|
58
|
+
/** Index in `message.content` of each after-tool segment's first block, by tool-call id. */
|
|
59
|
+
contentOffsets: ReadonlyMap<string, number>;
|
|
58
60
|
hasToolCalls: boolean;
|
|
59
61
|
lastToolCallId?: string;
|
|
60
62
|
};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** Pure occupancy calculations for contiguous token segments, independent of themes and renderers. */
|
|
2
|
+
export interface ContextMapSegment<T> {
|
|
3
|
+
readonly id: T;
|
|
4
|
+
readonly tokens: number;
|
|
5
|
+
}
|
|
6
|
+
export interface ContextMapCell<T> {
|
|
7
|
+
readonly id: T;
|
|
8
|
+
readonly full: boolean;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Lays `segments` out in order over a `columns` × `rows` grid representing `windowTokens`; each cell takes the
|
|
12
|
+
* segment covering most of it and is `full` at 70% coverage or more. Returns `[]` when the window or grid
|
|
13
|
+
* size is unusable, and omits cells no segment touches.
|
|
14
|
+
*/
|
|
15
|
+
export declare function planContextMap<T>(segments: readonly ContextMapSegment<T>[], windowTokens: number, columns: number, rows: number): ContextMapCell<T>[];
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { ContextCategoryId } from "./context-view-model.js";
|
|
2
|
+
export declare const CONTEXT_PRESENTATION: {
|
|
3
|
+
readonly "system-prompt": {
|
|
4
|
+
readonly color: "accent";
|
|
5
|
+
readonly symbol: "context.content";
|
|
6
|
+
};
|
|
7
|
+
readonly skills: {
|
|
8
|
+
readonly color: "success";
|
|
9
|
+
readonly symbol: "context.content";
|
|
10
|
+
};
|
|
11
|
+
readonly "built-in-tools": {
|
|
12
|
+
readonly color: "warning";
|
|
13
|
+
readonly symbol: "context.content";
|
|
14
|
+
};
|
|
15
|
+
readonly "custom-tools": {
|
|
16
|
+
readonly color: "customMessageLabel";
|
|
17
|
+
readonly symbol: "context.content";
|
|
18
|
+
};
|
|
19
|
+
readonly "user-messages": {
|
|
20
|
+
readonly color: "accent";
|
|
21
|
+
readonly symbol: "context.messages";
|
|
22
|
+
};
|
|
23
|
+
readonly "assistant-messages": {
|
|
24
|
+
readonly color: "userMessageText";
|
|
25
|
+
readonly symbol: "context.messages";
|
|
26
|
+
};
|
|
27
|
+
readonly "assistant-thinking": {
|
|
28
|
+
readonly color: "customMessageLabel";
|
|
29
|
+
readonly symbol: "context.content";
|
|
30
|
+
};
|
|
31
|
+
readonly "tool-calls": {
|
|
32
|
+
readonly color: "warning";
|
|
33
|
+
readonly symbol: "context.content";
|
|
34
|
+
};
|
|
35
|
+
readonly "tool-output": {
|
|
36
|
+
readonly color: "muted";
|
|
37
|
+
readonly symbol: "context.messages";
|
|
38
|
+
};
|
|
39
|
+
readonly buffer: {
|
|
40
|
+
readonly color: "warning";
|
|
41
|
+
readonly symbol: "context.buffer";
|
|
42
|
+
};
|
|
43
|
+
readonly free: {
|
|
44
|
+
readonly color: "dim";
|
|
45
|
+
readonly symbol: "context.free";
|
|
46
|
+
};
|
|
47
|
+
};
|
|
48
|
+
export type ContextPresentationId = ContextCategoryId | "buffer" | "free";
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/** Context snapshot shapes shared by the session snapshot builder and the context viewer. */
|
|
2
|
+
import type { ContextBreakdown } from "../status-line/context-usage.js";
|
|
3
|
+
interface ContextCategoryDescriptor {
|
|
4
|
+
readonly id: string;
|
|
5
|
+
readonly label: string;
|
|
6
|
+
/** Overview row label when the Overview weight differs from the category's content. */
|
|
7
|
+
readonly overviewLabel?: string;
|
|
8
|
+
/** Listed with its weight but never opened. */
|
|
9
|
+
readonly openable?: false;
|
|
10
|
+
}
|
|
11
|
+
/** Context categories in display order. */
|
|
12
|
+
export declare const CONTEXT_CATEGORIES: readonly [{
|
|
13
|
+
readonly id: "system-prompt";
|
|
14
|
+
readonly label: "System Prompt";
|
|
15
|
+
readonly overviewLabel: "System Prompt (excluding Skills)";
|
|
16
|
+
}, {
|
|
17
|
+
readonly id: "skills";
|
|
18
|
+
readonly label: "Skills";
|
|
19
|
+
readonly openable: false;
|
|
20
|
+
}, {
|
|
21
|
+
readonly id: "built-in-tools";
|
|
22
|
+
readonly label: "Built-in Tools";
|
|
23
|
+
}, {
|
|
24
|
+
readonly id: "custom-tools";
|
|
25
|
+
readonly label: "Custom Tools";
|
|
26
|
+
}, {
|
|
27
|
+
readonly id: "user-messages";
|
|
28
|
+
readonly label: "User / Developer Messages";
|
|
29
|
+
}, {
|
|
30
|
+
readonly id: "assistant-messages";
|
|
31
|
+
readonly label: "Assistant Messages";
|
|
32
|
+
}, {
|
|
33
|
+
readonly id: "assistant-thinking";
|
|
34
|
+
readonly label: "Assistant Thinking";
|
|
35
|
+
}, {
|
|
36
|
+
readonly id: "tool-calls";
|
|
37
|
+
readonly label: "Tool Calls";
|
|
38
|
+
}, {
|
|
39
|
+
readonly id: "tool-output";
|
|
40
|
+
readonly label: "Tool Output";
|
|
41
|
+
}];
|
|
42
|
+
export type ContextCategoryId = (typeof CONTEXT_CATEGORIES)[number]["id"];
|
|
43
|
+
/** Descriptor of a category id: its label, optional Overview label, and whether it can be opened. */
|
|
44
|
+
export declare function contextCategoryDescriptor(id: ContextCategoryId): ContextCategoryDescriptor;
|
|
45
|
+
export interface ContextThinkingGroup {
|
|
46
|
+
readonly id: string;
|
|
47
|
+
readonly label: string;
|
|
48
|
+
readonly tokens: number;
|
|
49
|
+
readonly interrupted?: boolean;
|
|
50
|
+
}
|
|
51
|
+
export interface ContextViewEntry {
|
|
52
|
+
readonly id: string;
|
|
53
|
+
readonly label: string;
|
|
54
|
+
readonly text: string;
|
|
55
|
+
/** Aggregation weight for the unscaled replay estimate; shared blocks contribute through their group. */
|
|
56
|
+
readonly tokens: number;
|
|
57
|
+
readonly interrupted?: boolean;
|
|
58
|
+
readonly thinkingGroup?: ContextThinkingGroup;
|
|
59
|
+
readonly path?: string;
|
|
60
|
+
readonly info?: string;
|
|
61
|
+
readonly timestamp?: number;
|
|
62
|
+
readonly callId?: string;
|
|
63
|
+
}
|
|
64
|
+
export interface ContextViewCategory {
|
|
65
|
+
id: ContextCategoryId;
|
|
66
|
+
key?: string;
|
|
67
|
+
label: string;
|
|
68
|
+
/** Overview attribution weight, not reported usage; may differ from the entry sum (e.g. Skills subtraction). */
|
|
69
|
+
tokens: number;
|
|
70
|
+
entries: ContextViewEntry[];
|
|
71
|
+
children?: ContextViewCategory[];
|
|
72
|
+
}
|
|
73
|
+
export interface ContextViewData {
|
|
74
|
+
readonly breakdown: ContextBreakdown;
|
|
75
|
+
readonly categories: readonly ContextViewCategory[];
|
|
76
|
+
}
|
|
77
|
+
export {};
|
|
@@ -16,5 +16,6 @@ export * from "./shared.js";
|
|
|
16
16
|
export * from "./streaming-panel.js";
|
|
17
17
|
export * from "./tool-activity.js";
|
|
18
18
|
export * from "./transcript-container.js";
|
|
19
|
+
export * from "./transcript-notice.js";
|
|
19
20
|
export * from "./transcript-status.js";
|
|
20
21
|
export * from "./visual-truncate.js";
|