@timurproko/a1 0.2.4 → 0.2.5-dev.698

package/dist/foundation/startup/startup-descriptor.js

@@ -10,7 +10,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   ],
   "generatedArtifact": {
     "path": "dist/integrations/pi/startup-public.js",
-    "sha256": "c115c1f4222f750961ed1d2d2b9b6c022f2948b070445b84e758c4d0c40d0bcd"
+    "sha256": "2adac500d8cebd5f7805c18a549ec0c6b23f13bd10ee5f3f463a6758f489e410"
   },
   "dependencyLayerIdentity": {
     "source": "A1_RELEASE_LAYERS",
@@ -19,7 +19,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   "compileCacheNamespace": {
     "strategy": "node-abi-version-and-ordered-layer-sha256-v1"
   },
-  "identity": "e2d043ae3f413047a59b2d289bbca7b46ff0eebbc040e652dc8f76677054f49e"
+  "identity": "b010b97970c6c40fe160224121793bf0b26d7c77e7860d8e787aaeb912333100"
 });
 
 export function loadDeclaredStartupGraph() {

package/dist/integrations/pi/components/index.d.ts

@@ -2,10 +2,11 @@ export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } fro
 export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
 export type { PiComponentConformanceReport, PiComponentConformanceResult } 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, type PiShellOperationLoaderPort, } 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 type { PiShellHotkeySection } from "./shell-hotkey-sections.js";
-export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellOperationLoaderPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";
+export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";
 export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
 export type { PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";

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;
@@ -305,11 +305,11 @@ export class ModelsDialogComponent {
                 const scoped = this.#scopeIds.includes(row.fullId);
                 // Invariant: arrow, scope marker, model id, [provider], then the active checkmark, in that order.
                 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() {
@@ -336,7 +336,7 @@ export class ModelsDialogComponent {
             ...(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/resources/builtin-themes.d.ts

@@ -1,6 +1,6 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.0.0 (MIT),
- * commit cd32f7725fdbddbaecdff5b1e68491563394e0ca.
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.0.4 (MIT),
+ * commit 7c10bd4337495ee613f2224843ecdf349b80d1df.
  * Upstream dark.json SHA-256: c11a588b714d35300293079b425fb09a3693d4b2d453585d211b08163c648b75
  * Upstream light.json SHA-256: f590c51c2bc8b238891efd0e983473ed2e2a6487b6692cc1d4b2845165e703f7
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.

package/dist/integrations/pi/components/resources/builtin-themes.js

@@ -1,6 +1,6 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.0.0 (MIT),
- * commit cd32f7725fdbddbaecdff5b1e68491563394e0ca.
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.0.4 (MIT),
+ * commit 7c10bd4337495ee613f2224843ecdf349b80d1df.
  * Upstream dark.json SHA-256: c11a588b714d35300293079b425fb09a3693d4b2d453585d211b08163c648b75
  * Upstream light.json SHA-256: f590c51c2bc8b238891efd0e983473ed2e2a6487b6692cc1d4b2845165e703f7
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.

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, {

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-presenters-info.d.ts

@@ -56,6 +56,8 @@ export interface PiShellCommandMessagePresentation {
     readonly detail?: string;
 }
 export declare function renderPiShellCommandMessage(presentation: PiShellCommandMessagePresentation, width: number, outputPad?: 0 | 1): readonly string[];
+/** The one-line warming status the pinned session report shows; a decision is attached once warming acted. */
+export declare function formatCacheWarmingStatus(status: NonNullable<PiShellCacheWarmingPresentation["status"]>, now?: number): string;
 export declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
 export declare function createPiShellCollapsedChangelog(): PiShellComponentPort;
 export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;

package/dist/integrations/pi/components/shell-presenters-info.js

@@ -56,7 +56,7 @@ function formatWarmingDecisionTime(nextWarmAt, now) {
     return `Decision in ${parts.join(" ")}`;
 }
 /** The one-line warming status the pinned session report shows; a decision is attached once warming acted. */
-function formatCacheWarmingStatus(status, now = Date.now()) {
+export function formatCacheWarmingStatus(status, now = Date.now()) {
     const decision = status.decision;
     if (!decision || (status.state === "inactive" && !decision.economicsAvailable && !status.extensionOverride)) {
         return `Inactive (${status.reason ?? "unknown reason"})`;

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.d.ts

@@ -0,0 +1,10 @@
+import { type PiShellSessionInfoPresentation } from "./shell-presenters-info.js";
+export interface PiShellSessionInfoReferenceDocument {
+    readonly preamble: readonly string[];
+    readonly sections: readonly {
+        readonly title: string;
+        readonly rows: readonly string[];
+    }[];
+}
+/** Renders the pinned report values while leaving group names semantic for the owned screen. */
+export declare function renderPiShellSessionInfoReferenceDocument(presentation: PiShellSessionInfoPresentation, width: number): PiShellSessionInfoReferenceDocument;