@timurproko/a1 0.2.5-dev.683 → 0.2.5-dev.704

package/dist/integrations/pi/components/index.js

@@ -1,7 +1,8 @@
 export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { createPiShellOperationLoader, createPiShellShareOperationDialog, } from "./share-operation-dialog.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";

package/dist/integrations/pi/components/modal-frame.d.ts

@@ -1,5 +1,15 @@
-import { Container, type Component } from "@earendil-works/pi-tui";
+import { Container, type Component, type TUI } from "@earendil-works/pi-tui";
 export declare const PI_MODAL_CONTENT_PADDING_X = 1;
+/** Adds the standard navigation/select/close footer before a dependency component's bottom rule. */
+export declare function addPiModalSelectFooter(container: Container): void;
+/** Owned cancellable operation frame with the canonical dialog close guidance. */
+export declare class PiCancellableOperationFrame extends Container {
+    #private;
+    constructor(tui: TUI, message: string);
+    get signal(): AbortSignal;
+    handleInput(data: string): void;
+    dispose(): void;
+}
 /** The semantic top rule/title pair used while a modal assembles its frame. */
 export declare class PiModalHeader implements Component {
     readonly rule: Component;

package/dist/integrations/pi/components/modal-frame.js

@@ -1,5 +1,33 @@
-import { Container, Spacer } from "@earendil-works/pi-tui";
+import { CancellableLoader, Container, Spacer, Text } from "@earendil-works/pi-tui";
+import { DynamicBorder } from "../startup-public.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalShortcutHints } from "./theme.js";
 export const PI_MODAL_CONTENT_PADDING_X = 1;
+/** Adds the standard navigation/select/close footer before a dependency component's bottom rule. */
+export function addPiModalSelectFooter(container) {
+    container.children.splice(container.children.length - 1, 0, new Text(renderPiModalShortcutHints([
+        { key: "↑↓", action: "navigate" }, { key: "enter", action: "select" }, DIALOG_CLOSE_SHORTCUT_HINT,
+    ]), 0, 0));
+}
+/** Owned cancellable operation frame with the canonical dialog close guidance. */
+export class PiCancellableOperationFrame extends Container {
+    #loader;
+    constructor(tui, message) {
+        super();
+        const theme = piTheme();
+        const border = (text) => theme.fg("border", text);
+        this.#loader = new CancellableLoader(tui, text => theme.fg("accent", text), text => theme.fg("muted", text), message);
+        this.addChild(new DynamicBorder(border));
+        this.addChild(this.#loader);
+        this.addChild(new Spacer(1));
+        this.addChild(new Text(renderPiModalShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT]), 0, 0));
+        this.addChild(new Spacer(1));
+        this.addChild(new DynamicBorder(border));
+        adoptPiModalFrame(this, { topIndex: 0, bottomIndex: this.children.length - 1 });
+    }
+    get signal() { return this.#loader.signal; }
+    handleInput(data) { this.#loader.handleInput(data); }
+    dispose() { this.#loader.dispose(); }
+}
 /** The semantic top rule/title pair used while a modal assembles its frame. */
 export class PiModalHeader {
     rule;

package/dist/integrations/pi/components/models-dialog.js

@@ -1,7 +1,16 @@
-import { Input, Key, getKeybindings, matchesKey, truncateToWidth, } from "@earendil-works/pi-tui";
+import { Input, getKeybindings, matchesKey, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
 import { DynamicBorder } from "../startup-public.js";
 import { PiModalFrame } from "./modal-frame.js";
-import { piTheme, renderPiModalShortcutHints } from "./theme.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalListRow, renderPiModalShortcutHints, } from "./theme.js";
+function renderHintsWithClose(entries, width) {
+    const body = renderPiModalShortcutHints(entries.slice(0, -1));
+    const close = renderPiModalShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT]);
+    const closeWidth = visibleWidth(close);
+    if (width <= closeWidth)
+        return truncateToWidth(close, width, "");
+    const clippedBody = truncateToWidth(body, Math.max(0, width - closeWidth - 2), "…");
+    return visibleWidth(clippedBody) === 0 ? close : `${clippedBody}  ${close}`;
+}
 const MAX_VISIBLE_ROWS = 10;
 const MODELS_TITLE = "Models";
 const REFRESHING_TITLE_MIN_DURATION_MS = 1_000;
@@ -166,7 +175,7 @@ export class ModelsDialogComponent {
                 this.#selectedIndex = this.#selectedIndex === rows.length - 1 ? 0 : this.#selectedIndex + 1;
             return;
         }
-        if (kb.matches(data, "tui.input.tab")) {
+        if (matchesKey(data, "shift+tab") || kb.matches(data, "tui.input.tab")) {
             this.#filter = this.#filter === "all" ? "scoped" : "all";
             this.#restoreSelection(preferredId);
             return;
@@ -221,15 +230,6 @@ export class ModelsDialogComponent {
             this.#setScope(next, selected.fullId);
             return;
         }
-        if (matchesKey(data, Key.ctrl("c"))) {
-            if (this.#input.getValue().length > 0) {
-                this.#input.setValue("");
-                this.#selectedIndex = 0;
-                return;
-            }
-            this.#callbacks.onCancel();
-            return;
-        }
         if (kb.matches(data, "tui.select.cancel")) {
             this.#callbacks.onCancel();
             return;
@@ -303,13 +303,13 @@ export class ModelsDialogComponent {
                 const row = rows[index];
                 const selected = index === this.#selectedIndex;
                 const scoped = this.#scopeIds.includes(row.fullId);
-                // Invariant: arrow, scope marker, model id, [provider], then the active checkmark, in that order.
+                // Invariant: arrow, scope marker, model id, [provider], then the active checkmark.
                 const prefix = selected ? theme.fg("accent", "→ ") : "  ";
-                const marker = scoped ? theme.fg("success", "●") : theme.fg("dim", "○");
-                const label = selected ? theme.fg("accent", row.model.id) : row.model.id;
+                const marker = scoped ? theme.fg("accent", "●") : theme.fg("dim", "○");
+                const label = selected ? theme.fg("text", row.model.id) : row.model.id;
                 const provider = theme.fg("muted", `[${row.model.provider}]`);
                 const active = row.fullId === this.#activeModelId ? ` ${theme.fg("success", "✓")}` : "";
-                push(`${prefix}${marker} ${label} ${provider}${active}`);
+                push(renderPiModalListRow(`${prefix}${marker} ${label} ${provider}${active}`, width, selected));
             }
             if (startIndex > 0 || endIndex < rows.length)
                 push(theme.fg("muted", `  (${this.#selectedIndex + 1}/${rows.length})`));
@@ -322,7 +322,7 @@ export class ModelsDialogComponent {
         push();
         if (this.#refreshStatus !== undefined)
             push(theme.fg(this.#refreshStatus.kind, `  ${this.#refreshStatus.message}`));
-        push(renderPiModalShortcutHints(this.#hints()));
+        push(renderHintsWithClose(this.#hints(), width));
         return lines;
     }
     #hints() {
@@ -330,13 +330,13 @@ export class ModelsDialogComponent {
         const confirm = keyLabel("tui.select.confirm");
         const save = keyLabel("app.models.save");
         return [
-            { action: "type to search" },
+            { key: "Type", action: "search" },
             { key: "↑↓", action: "navigate" },
             ...(tab.length === 0 ? [] : [{ key: tab, action: "filter" }]),
             ...(confirm.length === 0 ? [] : [{ key: confirm, action: "switch" }]),
             { key: "space", action: "scope" },
             ...(save.length === 0 ? [] : [{ key: save, action: "save" }]),
-            { key: "esc", action: "close" },
+            DIALOG_CLOSE_SHORTCUT_HINT,
         ];
     }
     #emptyText() {

package/dist/integrations/pi/components/share-operation-dialog.d.ts

@@ -0,0 +1,6 @@
+import { type PiShellComponentPort, type PiShellEditorOptions } from "./shell-shared-facade.js";
+export interface PiShellOperationLoaderPort extends PiShellComponentPort {
+    readonly signal: AbortSignal;
+}
+export declare function createPiShellShareOperationDialog(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellOperationLoaderPort;
+export declare function createPiShellOperationLoader(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellOperationLoaderPort;

package/dist/integrations/pi/components/share-operation-dialog.js

@@ -0,0 +1,40 @@
+import { CancellableLoader, Spacer, Text, } from "@earendil-works/pi-tui";
+import { BorderedLoader, DynamicBorder } from "../startup-public.js";
+import { adoptPiModalFrame, PiModalFrame } from "./modal-frame.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalShortcutHints } from "./theme.js";
+import { componentPort, createTuiFacade, ensureTheme, } from "./shell-shared-facade.js";
+/** Bare A1's titled share progress surface; the pinned comparison keeps its bordered loader. */
+class ShareOperationDialog {
+    #loader;
+    #frame;
+    constructor(runtime, message) {
+        const theme = piTheme();
+        this.#loader = new CancellableLoader(createTuiFacade(runtime), text => theme.fg("accent", text), text => theme.fg("muted", text), message);
+        this.#frame = new PiModalFrame(new DynamicBorder(text => theme.fg("border", text)), [
+            new Text(theme.fg("accent", theme.bold("Share")), 0, 0),
+            this.#loader,
+            new Spacer(1),
+            new Text(renderPiModalShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT]), 0, 0),
+        ], new DynamicBorder(text => theme.fg("border", text)));
+    }
+    get signal() { return this.#loader.signal; }
+    invalidate() { this.#frame.invalidate(); }
+    render(width) { return this.#frame.render(width); }
+    handleInput(data) { this.#loader.handleInput(data); }
+    dispose() { this.#loader.dispose(); }
+}
+export function createPiShellShareOperationDialog(runtime, message) {
+    ensureTheme();
+    const dialog = new ShareOperationDialog(runtime, message);
+    return { ...componentPort(dialog), signal: dialog.signal };
+}
+export function createPiShellOperationLoader(runtime, message) {
+    ensureTheme();
+    const loader = new BorderedLoader(createTuiFacade(runtime), piTheme(), message, { cancellable: true });
+    adoptPiModalFrame(loader, {
+        topIndex: 0,
+        bottomIndex: loader.children.length - 1,
+        preInsetContent: loader.children[3] === undefined ? [] : [loader.children[3]],
+    });
+    return { ...componentPort(loader), signal: loader.signal };
+}

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -4,11 +4,21 @@ import { PROMPT_HISTORY_EDITOR_REPLACEMENT } from "../../../contracts/owned-ui/i
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { OwnedEditor } from "./upstream/components/owned-editor.js";
 import { OwnedEditorUxInterception, createPromptSelectionInterceptor, editorVisualLineCount, } from "./owned-editor-ux.js";
-import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
+import { PINNED_PI_LAYOUT, piTheme, renderPiListSelection, } from "./theme.js";
 import { createTuiFacade, ensureTheme, isAutocompleteProvider, } from "./shell-shared-facade.js";
 import { SKILLS_COMMAND_NAME, collapseSkillCommands, createSkillsTunnelProvider, } from "./skills-command.js";
-/** A selected autocomplete row: the accent primary column, then the aligned description. */
+/** A selected autocomplete row: its arrow/primary column, then the aligned description. */
 const SELECTED_DESCRIBED_ROW = /^(→ .*?\S)(\s{2,}.*)$/u;
+function renderOwnedAutocompleteSelection(text) {
+    const theme = piTheme();
+    const row = SELECTED_DESCRIBED_ROW.exec(text);
+    const primary = row?.[1] ?? text;
+    const hasArrow = primary.startsWith("→ ");
+    const arrow = hasArrow ? theme.fg("accent", "→ ") : "";
+    const label = theme.fg("text", hasArrow ? primary.slice(2) : primary);
+    const description = row === null ? "" : theme.fg("muted", row[2]);
+    return renderPiListSelection(arrow + label + description);
+}
 const PINNED_THINKING_SLASH_COMMAND = { name: "thinking", description: "Set thinking level", argumentHint: "<level>" };
 const OWNED_THINKING_SLASH_COMMAND = { name: "thinking", description: "Set thinking level" };
 const OWNED_LOGIN_SLASH_COMMAND = { name: "login", description: "Configure provider authentication" };
@@ -74,10 +84,9 @@ export function createPiShellEditor(options) {
                 return selectListTheme.scrollInfo(text);
             },
             selectedText: text => {
-                // Rationale: the pinned list styles a whole selected row at once. Bare A1 keeps the
-                // actionable primary column accented while every aligned description remains muted.
-                const row = SELECTED_DESCRIBED_ROW.exec(text);
-                return row === null ? selectListTheme.selectedText(text) : selectListTheme.selectedText(row[1]) + selectListTheme.description(row[2]);
+                // Rationale: bare A1 keeps the arrow accented, the actionable label readable, and descriptions muted
+                // on the same item-bounded blue surface used by its standard modal selectors.
+                return renderOwnedAutocompleteSelection(text);
             },
         },
     }, keybindings, {
@@ -152,8 +161,12 @@ export function createPiShellEditor(options) {
         const resources = commands
             .filter(command => command.name !== collapsed.collapsedCommand?.name && command.source !== "builtin" && !builtInNames.has(command.name))
             .map(command => autocompleteCommand(command));
-        const combined = new CombinedAutocompleteProvider([...builtIns, ...resources], options.cwd ?? process.cwd());
-        autocompleteProvider = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
+        const catalog = [...builtIns, ...resources];
+        const combined = new CombinedAutocompleteProvider(catalog, options.cwd ?? process.cwd());
+        const tunnelAware = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
+        autocompleteProvider = options.keybindingProfile === "a1"
+            ? createDelimiterReadyCommandProvider(tunnelAware, catalog)
+            : tunnelAware;
         editor.setAutocompleteProvider(autocompleteProvider);
     };
     setAutocompleteCommands(options.autocompleteCommands ?? []);
@@ -336,6 +349,40 @@ export function createPiShellEditor(options) {
         cancelPendingPastes: () => editorUx?.cancelPendingPastes(),
     };
 }
+/** Bare A1 leaves an applied catalog command ready for `:`, a user-entered space, or submission. */
+function createDelimiterReadyCommandProvider(base, commands) {
+    const commandNames = new Set(commands.map(command => command.name));
+    return {
+        ...(base.triggerCharacters === undefined ? {} : { triggerCharacters: base.triggerCharacters }),
+        getSuggestions: (lines, cursorLine, cursorCol, options) => base.getSuggestions(lines, cursorLine, cursorCol, options),
+        applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+            const result = base.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
+            const currentLine = lines[cursorLine] ?? "";
+            const textBeforeCursor = currentLine.slice(0, cursorCol);
+            const beforePrefix = currentLine.slice(0, cursorCol - prefix.length);
+            const completedLine = result.lines[result.cursorLine] ?? "";
+            const spacerIndex = result.cursorCol - 1;
+            const expectedCommand = `${beforePrefix}/${item.value}`;
+            const isCatalogCommand = commandNames.has(item.value)
+                && prefix.startsWith("/")
+                && !prefix.slice(1).includes("/")
+                && !prefix.includes(" ")
+                && textBeforeCursor.trimStart() === prefix;
+            if (!isCatalogCommand
+                || result.cursorLine !== cursorLine
+                || spacerIndex < 0
+                || completedLine[spacerIndex] !== " "
+                || completedLine.slice(0, spacerIndex) !== expectedCommand)
+                return result;
+            const nextLines = [...result.lines];
+            nextLines[result.cursorLine] = completedLine.slice(0, spacerIndex) + completedLine.slice(spacerIndex + 1);
+            return { ...result, lines: nextLines, cursorCol: spacerIndex };
+        },
+        ...(base.shouldTriggerFileCompletion === undefined ? {} : {
+            shouldTriggerFileCompletion: (lines, cursorLine, cursorCol) => base.shouldTriggerFileCompletion(lines, cursorLine, cursorCol),
+        }),
+    };
+}
 function autocompleteCommand(command, addition) {
     const argumentOptions = addition?.argumentOptions ?? command.argumentOptions;
     return {

package/dist/integrations/pi/components/shell-extension-ui.d.ts

@@ -28,6 +28,9 @@ export interface PiExtensionUiBridgeHost {
 }
 export interface PiExtensionUiBridge {
     readonly context: ExtensionUIContext;
+    input(title: string, placeholder: string, options?: {
+        readonly retainSurfaceOnSettle?: boolean;
+    }): Promise<string | undefined>;
     reset(): void;
     dispose(): void;
 }

package/dist/integrations/pi/components/shell-extension-ui.js

@@ -5,7 +5,7 @@ import { ExtensionSelectorComponent } from "./upstream/components/extension-sele
 import { setKeybindings, Text, } from "@earendil-works/pi-tui";
 import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
 import { PINNED_PI_LAYOUT, applyPiTheme, applyPiThemeInstance, getAvailablePiThemes, loadPiTheme, piTheme, } from "./theme.js";
-import { componentPort, createTuiFacade, ensureTheme, isRecord, } from "./shell-shared-facade.js";
+import { componentPort, createTuiFacade, ensureTheme, isRecord, withPiDialogCancel, } from "./shell-shared-facade.js";
 /** Public ExtensionUIContext ported from pinned InteractiveMode without constructing it. */
 export function createPiExtensionUiBridge(host) {
     ensureTheme();
@@ -45,7 +45,7 @@ export function createPiExtensionUiBridge(host) {
             disposers.delete(dispose);
         };
     };
-    const showInput = (create, options) => new Promise(resolve => {
+    const showInput = (create, options, retainSurfaceOnSettle = false) => new Promise(resolve => {
         let settled = false;
         let surface;
         let untrack = () => { };
@@ -56,7 +56,10 @@ export function createPiExtensionUiBridge(host) {
             if (activeCancel === cancel)
                 activeCancel = undefined;
             untrack();
-            closeSurface(surface);
+            if (retainSurfaceOnSettle && activeSurface === surface)
+                activeSurface = undefined;
+            else
+                closeSurface(surface);
             resolve(value);
         };
         const cancel = () => finish(undefined);
@@ -173,7 +176,7 @@ export function createPiExtensionUiBridge(host) {
                         component.dispose();
                     return;
                 }
-                surface = componentPort(component);
+                surface = withPiDialogCancel(componentPort(component), cancelCustom);
                 activeCancel = cancelCustom;
                 if (options?.overlay) {
                     const overlayOptions = typeof options.overlayOptions === "function" ? options.overlayOptions() : options.overlayOptions;
@@ -247,6 +250,7 @@ export function createPiExtensionUiBridge(host) {
     };
     return {
         context,
+        input: (title, placeholder, options) => showInput((resolve, cancel) => componentPort(new ExtensionInputComponent(title, placeholder, resolve, cancel, { tui })), undefined, options?.retainSurfaceOnSettle === true),
         reset,
         dispose() {
             reset();

package/dist/integrations/pi/components/shell-selectors-dialogs.d.ts

@@ -110,10 +110,6 @@ export interface PiShellLoginDialogPort extends PiShellComponentPort {
 export declare function createPiShellLoginDialog(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, providerId: string, onComplete: (success: boolean, message?: string) => void, providerName?: string, title?: string): PiShellLoginDialogPort;
 export declare function createPiShellArmin(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellComponentPort;
 export declare function createPiShellEarendilAnnouncement(): PiShellComponentPort;
-export interface PiShellOperationLoaderPort extends PiShellComponentPort {
-    readonly signal: AbortSignal;
-}
-export declare function createPiShellOperationLoader(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellOperationLoaderPort;
 export declare function createPiShellReloadBox(): PiShellComponentPort;
 export interface PiShellAuthProviderOption extends PiShellSelectorOption {
     readonly providerId: string;

package/dist/integrations/pi/components/shell-selectors-dialogs.js

@@ -1,11 +1,12 @@
-import { ArminComponent, BorderedLoader, DynamicBorder, ExtensionSelectorComponent, getSelectListTheme, LoginDialogComponent, ModelSelectorComponent, OAuthSelectorComponent, SettingsSelectorComponent, ShowImagesSelectorComponent, ThemeSelectorComponent, UserMessageSelectorComponent, } from "../startup-public.js";
-import { EarendilAnnouncementComponent, } from "./upstream/components/earendil-announcement.js";
+import { ArminComponent, DynamicBorder, getSelectListTheme, LoginDialogComponent, ModelSelectorComponent, OAuthSelectorComponent, SettingsSelectorComponent, ShowImagesSelectorComponent, ThemeSelectorComponent, UserMessageSelectorComponent, } from "../startup-public.js";
+import { EarendilAnnouncementComponent } from "./upstream/components/earendil-announcement.js";
+import { ExtensionSelectorComponent } from "./upstream/components/extension-selector.js";
 import { Box, Container, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
-import { ScopedModelsSelectorComponent, } from "./upstream/components/scoped-models-selector.js";
-import { adoptPiModalFrame, adoptPiModalHeader } from "./modal-frame.js";
-import { ModelsDialogComponent, } from "./models-dialog.js";
-import { TrustSelectorComponent, } from "./upstream/components/trust-selector.js";
-import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
+import { ScopedModelsSelectorComponent } from "./upstream/components/scoped-models-selector.js";
+import { addPiModalSelectFooter, adoptPiModalFrame, adoptPiModalHeader } from "./modal-frame.js";
+import { ModelsDialogComponent } from "./models-dialog.js";
+import { TrustSelectorComponent } from "./upstream/components/trust-selector.js";
+import { canonicalizePiSettingsHint, DIALOG_CLOSE_SHORTCUT_HINT, PINNED_PI_LAYOUT, piTheme, renderPiModalShortcutHints, } from "./theme.js";
 import { componentFromPort, componentPort, createTuiFacade, ensureTheme, isRecord, } from "./shell-shared-facade.js";
 export { createPiShellSkillsSelector } from "./skills-dialog.js";
 export function createPiShellSelector(options) {
@@ -16,11 +17,20 @@ export function createPiShellSelector(options) {
         list.onSelect = item => options.onSelect?.(item.value);
     if (options.onCancel !== undefined)
         list.onCancel = options.onCancel;
-    if (!options.title)
+    if (!options.title && options.onCancel === undefined)
         return componentPort(list);
     const container = new Container();
-    container.addChild(new Text(piTheme().fg("accent", piTheme().bold(options.title)), PINNED_PI_LAYOUT.contentPaddingX, 0));
+    if (options.title)
+        container.addChild(new Text(piTheme().fg("accent", piTheme().bold(options.title)), PINNED_PI_LAYOUT.contentPaddingX, 0));
     container.addChild(list);
+    if (options.onCancel !== undefined) {
+        container.addChild(new Spacer(1));
+        container.addChild(new Text(renderPiModalShortcutHints([
+            { key: "↑↓", action: "navigate" },
+            { key: "enter", action: "select" },
+            DIALOG_CLOSE_SHORTCUT_HINT,
+        ]), 0, 0));
+    }
     return componentPort(container, data => list.handleInput(data));
 }
 export function createPiShellSettingsSelector(options) {
@@ -68,7 +78,19 @@ export function createPiShellSettingsSelector(options) {
     };
     const selector = new SettingsSelectorComponent(options.config, callbacks);
     const settingsList = selector.getSettingsList();
-    return componentPort(selector, data => settingsList.handleInput(data));
+    const port = componentPort(selector, data => settingsList.handleInput(data));
+    return {
+        ...port,
+        // Rationale: Pi's nested settings components own their hint rows and do not expose hint entries.
+        // Rebuild only the footer row so the canonical close entry survives narrow clipping.
+        render(width) {
+            const rows = [...port.render(width)];
+            const hintIndex = rows.length - 2;
+            if (rows[hintIndex] !== undefined)
+                rows[hintIndex] = canonicalizePiSettingsHint(rows[hintIndex], width);
+            return rows;
+        },
+    };
 }
 export function createPiShellModelSelector(options) {
     ensureTheme();
@@ -139,6 +161,7 @@ export function createPiShellUserMessageSelector(messages, onSelect, onCancel, i
     ensureTheme();
     const selector = new UserMessageSelectorComponent(messages.map(message => ({ id: message.id, text: message.label })), onSelect, onCancel, initialSelectedId);
     const list = selector.getMessageList();
+    addPiModalSelectFooter(selector);
     adoptPiModalFrame(selector, { topIndex: 4, bottomIndex: selector.children.length - 1 });
     return componentPort(selector, data => list.handleInput(data));
 }
@@ -146,6 +169,9 @@ export function createPiShellLoginDialog(runtime, providerId, onComplete, provid
     ensureTheme();
     const dialog = new LoginDialogComponent(createTuiFacade(runtime), providerId, onComplete, providerName, title);
     const preInsetTitle = dialog.children[1];
+    const content = dialog.children[2];
+    dialog.children.splice(dialog.children.length - 1, 0, new Spacer(1), new Text(renderPiModalShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT]), 0, 0));
+    const removeDependencyHint = () => { content.children.pop(); };
     const header = adoptPiModalHeader(dialog, 0, 1);
     adoptPiModalFrame(dialog, {
         topIndex: 0,
@@ -157,11 +183,23 @@ export function createPiShellLoginDialog(runtime, providerId, onComplete, provid
         ...componentPort(dialog),
         showAuth: (url, instructions) => dialog.showAuth(url, instructions),
         showDeviceCode: info => dialog.showDeviceCode(info),
-        showManualInput: message => dialog.showManualInput(message),
-        showPrompt: (message, placeholder) => dialog.showPrompt(message, placeholder),
+        showManualInput(message) {
+            const result = dialog.showManualInput(message);
+            removeDependencyHint();
+            return result;
+        },
+        showPrompt(message, placeholder) {
+            const result = dialog.showPrompt(message, placeholder);
+            removeDependencyHint();
+            return result;
+        },
         showDetails: lines => dialog.showDetails([...lines]),
-        showInfo: (message, links = [], showCloseHint = false) => dialog.showInfo(message, [...links], showCloseHint),
-        showWaiting: message => dialog.showWaiting(message),
+        // Rationale: The persistent canonical footer replaces the dependency's optional close hint.
+        showInfo: (message, links = []) => dialog.showInfo(message, [...links], false),
+        showWaiting(message) {
+            dialog.showWaiting(message);
+            removeDependencyHint();
+        },
         showProgress: message => dialog.showProgress(message),
     };
 }
@@ -173,16 +211,6 @@ export function createPiShellEarendilAnnouncement() {
     ensureTheme();
     return componentPort(new EarendilAnnouncementComponent());
 }
-export function createPiShellOperationLoader(runtime, message) {
-    ensureTheme();
-    const loader = new BorderedLoader(createTuiFacade(runtime), piTheme(), message, { cancellable: true });
-    adoptPiModalFrame(loader, {
-        topIndex: 0,
-        bottomIndex: loader.children.length - 1,
-        preInsetContent: loader.children[3] === undefined ? [] : [loader.children[3]],
-    });
-    return { ...componentPort(loader), signal: loader.signal };
-}
 export function createPiShellReloadBox() {
     ensureTheme();
     const container = new Container();
@@ -207,6 +235,7 @@ export function createPiShellAuthProviderSelector(mode, providers, onSelect, onC
         if (selected)
             onSelect(selected.id);
     }, onCancel, initialSearchInput);
+    addPiModalSelectFooter(selector);
     const preInsetContent = [selector.children[2], selector.children[6]];
     const header = adoptPiModalHeader(selector, 0, 2);
     adoptPiModalFrame(selector, {
@@ -219,21 +248,13 @@ export function createPiShellAuthProviderSelector(mode, providers, onSelect, onC
 }
 export function createPiShellExtensionSelector(title, options, onSelect, onCancel) {
     ensureTheme();
-    const selector = new ExtensionSelectorComponent(title, [...options], onSelect, onCancel);
-    const preInsetContent = [selector.children[2], selector.children[4], selector.children[6]];
-    const header = adoptPiModalHeader(selector, 0, 2);
-    adoptPiModalFrame(selector, {
-        topIndex: 0,
-        bottomIndex: selector.children.length - 1,
-        header,
-        preInsetContent,
-    });
-    return componentPort(selector);
+    return componentPort(new ExtensionSelectorComponent(title, [...options], onSelect, onCancel));
 }
 export function createPiShellThemeSelector(currentTheme, onSelect, onCancel, onPreview) {
     ensureTheme();
     const selector = new ThemeSelectorComponent(currentTheme, onSelect, onCancel, onPreview);
     const list = selector.getSelectList();
+    addPiModalSelectFooter(selector);
     adoptPiModalFrame(selector, { topIndex: 0, bottomIndex: selector.children.length - 1 });
     return componentPort(selector, data => list.handleInput(data));
 }
@@ -241,6 +262,7 @@ export function createPiShellShowImagesSelector(currentValue, onSelect, onCancel
     ensureTheme();
     const selector = new ShowImagesSelectorComponent(currentValue, onSelect, onCancel);
     const list = selector.getSelectList();
+    addPiModalSelectFooter(selector);
     adoptPiModalFrame(selector, { topIndex: 0, bottomIndex: selector.children.length - 1 });
     return componentPort(selector, data => list.handleInput(data));
 }

package/dist/integrations/pi/components/shell-session-info-reference.js

@@ -1,7 +1,40 @@
-import { Text } from "@earendil-works/pi-tui";
+import { sliceByColumn, Text, visibleWidth } from "@earendil-works/pi-tui";
 import { formatCacheWarmingStatus } from "./shell-presenters-info.js";
 import { ensureTheme, formatSessionTokens } from "./shell-shared-facade.js";
 import { piTheme } from "./theme.js";
+/** Splits a plain path by visible columns, preserving every source grapheme in order. */
+function splitSessionFile(sessionFile, firstWidth, continuationWidth) {
+    const rows = [];
+    let remaining = sessionFile;
+    let rowWidth = firstWidth;
+    while (remaining) {
+        let row = sliceByColumn(remaining, 0, rowWidth, true);
+        if (!row && rowWidth !== continuationWidth) {
+            rows.push("");
+            rowWidth = continuationWidth;
+            continue;
+        }
+        // Compatibility: a one-column frame cannot fit a wide grapheme; preserve it for outer truncation.
+        if (!row)
+            row = sliceByColumn(remaining, 0, rowWidth);
+        rows.push(row);
+        remaining = remaining.slice(row.length);
+        rowWidth = continuationWidth;
+    }
+    return rows.length > 0 ? rows : [""];
+}
+/** Keeps the file value on its labelled row before using full continuation rows. */
+function sessionFileRows(sessionFile, width) {
+    // Compatibility: match Text's reduced-padding rule so these explicit breaks survive its renderer.
+    const paddingX = Math.min(1, Math.max(0, Math.floor((width - 1) / 2)));
+    const contentWidth = Math.max(1, width - paddingX * 2);
+    const label = piTheme().fg("dim", "File:");
+    const firstValueWidth = Math.max(0, contentWidth - visibleWidth("File: "));
+    const [first = "", ...continuation] = splitSessionFile(sessionFile, firstValueWidth, contentWidth);
+    return firstValueWidth > 0
+        ? [`${label} ${first}`, ...continuation]
+        : [label, ...continuation];
+}
 /** Renders the pinned report values while leaving group names semantic for the owned screen. */
 export function renderPiShellSessionInfoReferenceDocument(presentation, width) {
     ensureTheme();
@@ -9,7 +42,7 @@ export function renderPiShellSessionInfoReferenceDocument(presentation, width) {
     const render = (rows) => new Text(rows.join("\n"), 1, 0).render(width);
     const preamble = [
         ...(sessionName ? [`${piTheme().fg("dim", "Name:")} ${sessionName}`] : []),
-        `${piTheme().fg("dim", "File:")} ${stats.sessionFile ?? "In-memory"}`,
+        ...sessionFileRows(stats.sessionFile ?? "In-memory", width),
         `${piTheme().fg("dim", "ID:")} ${stats.sessionId}`,
     ];
     const messages = [

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -46,7 +46,7 @@ export interface PiShellEditorPort extends PiShellComponentPort {
     keybindingConfig(): KeybindingsConfig;
     reloadKeybindings(): void;
     /** Uses Pi's terminal decoder rather than assuming one terminal escape spelling. */
-    matchesTerminalKey(data: string, key: "home" | "end" | "ctrl+home" | "ctrl+end" | "alt+home" | "ctrl+v"): boolean;
+    matchesTerminalKey(data: string, key: "home" | "end" | "pageUp" | "pageDown" | "ctrl+home" | "ctrl+end" | "alt+home" | "ctrl+v"): boolean;
     getText(): string;
     setText(text: string): void;
     insertText(text: string): void;
@@ -227,6 +227,8 @@ export declare function createTuiFacade(options: Pick<PiShellEditorOptions, "get
     readonly onSubmit?: (text: string) => void;
 }): TUI;
 export declare function componentPort(component: Component, handleInput?: (data: string) => void): PiShellComponentPort;
+/** Gives an extension-hosted dialog the shell's implicit close alias without rewriting its component. */
+export declare function withPiDialogCancel(port: PiShellComponentPort, onCancel: () => void): PiShellComponentPort;
 export declare function componentFromPort(port: PiShellComponentPort): Component;
 export declare function formatSessionTokens(count: number): string;
 export declare function isAutocompleteProvider(value: unknown): value is AutocompleteProvider;

package/dist/integrations/pi/components/shell-shared-facade.js

@@ -1,4 +1,4 @@
-import { hyperlink, setKeybindings, visibleWidth, truncateToWidth, } from "@earendil-works/pi-tui";
+import { hyperlink, matchesKey, setKeybindings, visibleWidth, truncateToWidth, } from "@earendil-works/pi-tui";
 import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
 import { ensurePiTheme, } from "./theme.js";
 /** Terminal-cell width authority used by Pi-rendered component rows. */
@@ -61,6 +61,18 @@ export function componentPort(component, handleInput) {
         ...(typeof disposable.dispose === "function" ? { dispose: () => disposable.dispose?.() } : {}),
     };
 }
+/** Gives an extension-hosted dialog the shell's implicit close alias without rewriting its component. */
+export function withPiDialogCancel(port, onCancel) {
+    return {
+        ...port,
+        handleInput: data => {
+            if (matchesKey(data, "ctrl+c"))
+                onCancel();
+            else
+                port.handleInput?.(data);
+        },
+    };
+}
 export function componentFromPort(port) {
     return {
         render: width => [...port.render(width)],